1 line
20 KiB
JSON
1 line
20 KiB
JSON
{"repo": "baminq/freehub", "files": {"gitbook/content/vi/integration/other-tools.md": {"9902cf45f7d39e5b1b7b9f3a818048588c88bae4": {"t": 1785746498.777157, "n": 8901, "h": "112ae36200ae684c", "c": "# Tích hợp các Công cụ khác\n\n9Router tương thích với mọi công cụ hỗ trợ format API OpenAI. Hướng dẫn này bao gồm pattern tích hợp tổng quát cho nhiều công cụ và ứng dụng tùy chỉnh.\n\n## Tổng quan\n\n9Router cung cấp API endpoint tương thích OpenAI hoạt động với:\n- Script và ứng dụng tùy chỉnh\n- API client và công cụ test\n- Công cụ CLI và utility\n- Tích hợp bên thứ ba\n- Framework phát triển\n\n## Pattern Setup Tổng quát\n\nMọi công cụ tương thích OpenAI có thể kết nối đến 9Router bằng các cài đặt sau:\n\n**9Router cục bộ:**\n```\nBase URL: http://localhost:20128/v1\nAPI Key: your-api-key-from-dashboard\nModel: any 9Router model (cc/*, cx/*, glm/*, etc.)\n```\n\n**9Router cloud:**\n```\nBase URL: https://9router.com/v1\nAPI Key: your-api-key-from-dashboard\nModel: any 9Router model (cc/*, cx/*, glm/*, etc.)\n```\n\n## Model có sẵn\n\n### Claude Models (Anthropic)\n- `cc/claude-opus-4-5-20251101`\n- `cc/claude-sonnet-4-20250514`\n- `cc/claude-haiku-4-20250514`\n\n### DeepSeek Models\n- `cx/deepseek-chat`\n- `cx/deepseek-reasoner`\n\n### GLM Models (Zhipu AI)\n- `glm/glm-4-plus`\n- `glm/glm-4-flash`\n\n## Ví dụ Tích hợp\n\n### Python với OpenAI SDK\n\n```python\nfrom openai import OpenAI\n\nclient = OpenAI(\n api_key=\"your-api-key-from-dashboard\",\n base_url=\"http://localhost:20128/v1\"\n)\n\nresponse = client.chat.completions.create(\n model=\"cc/claude-sonnet-4-20250514\",\n messages=[\n {\"role\": \"user\", \"content\": \"Hello, how are you?\"}\n ]\n)\n\nprint(response.choices[0].message.content)\n```\n\n### Node.js với OpenAI SDK\n\n```javascript\nimport OpenAI from \"openai\";\n\nconst client = new OpenAI({\n apiKey: \"your-api-key-from-dashboard\",\n baseURL: \"http://localhost:20128/v1\"\n});\n\nconst response = await client.chat.completions.create({\n model: \"cc/claude-sonnet-4-20250514\",\n messages: [\n { role: \"user\", content: \"Hello, how are you?\" }\n ]\n});\n\nconsole.log(response.choices[0].message.content);\n```\n\n### Lệnh cURL\n\n```bash\ncurl http://localhost:20128/v1/chat/completions \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-api-key-from-dashboard\" \\\n -d '{\n \"model\": \"cc/claude-sonnet-4-20250514\",\n \"messages\": [\n {\"role\": \"user\", \"content\": \"Hello, how are you?\"}\n ]\n }'\n```\n\n### HTTP Client (Postman, Insomnia)\n\n**Request:**\n```\nPOST http://localhost:20128/v1/chat/completions\n```\n\n**Headers:**\n```\nContent-Type: application/json\nAuthorization: Bearer your-api-key-from-dashboard\n```\n\n**Body:**\n```json\n{\n \"model\": \"cc/claude-sonnet-4-20250514\",\n \"messages\": [\n {\"role\": \"user\", \"content\": \"Hello, how are you?\"}\n ],\n \"temperature\": 0.7,\n \"max_tokens\": 1000\n}\n```\n\n### Tích hợp LangChain\n\n```python\nfrom langchain.chat_models import ChatOpenAI\nfrom langchain.schema import HumanMessage\n\nllm = ChatOpenAI(\n model_name=\"cc/claude-sonnet-4-20250514\",\n openai_api_key=\"your-api-key-from-dashboard\",\n openai_api_base=\"http://localhost:20128/v1\",\n temperature=0.7\n)\n\nmessages = [HumanMessage(content=\"Explain quantum computing\")]\nresponse = llm(messages)\nprint(response.content)\n```\n\n### Tích hợp LlamaIndex\n\n```python\nfrom llama_index.llms import OpenAI\n\nllm = OpenAI(\n model=\"cc/claude-sonnet-4-20250514\",\n api_key=\"your-api-key-from-dashboard\",\n api_base=\"http://localhost:20128/v1\"\n)\n\nresponse = llm.complete(\"What is machine learning?\")\nprint(response.text)\n```\n\n## Ví dụ Script Tùy chỉnh\n\n### Script Xử lý Batch\n\n```python\nimport openai\nimport json\n\nopenai.api_key = \"your-api-key-from-dashboard\"\nopenai.api_base = \"http://localhost:20128/v1\"\n\ndef process_batch(prompts, model=\"cx/deepseek-chat\"):\n results = []\n for prompt in prompts:\n response = openai.ChatCompletion.create(\n model=model,\n messages=[{\"role\": \"user\", \"content\": prompt}]\n )\n results.append({\n \"prompt\": prompt,\n \"response\": response.choices[0].message.content\n })\n return results\n\nprompts = [\n \"Explain AI in one sentence\",\n \"What is machine learning?\",\n \"Define neural networks\"\n]\n\nresults = process_batch(prompts)\nprint(json.dumps(results, indent=2))\n```\n\n### Xử lý Streaming Response\n\n```javascript\nimport OpenAI from \"openai\";\n\nconst client = new OpenAI({\n apiKey: \"your-api-key-from-dashboard\",\n baseURL: \"http://localhost:20128/v1\"\n});\n\nasync function streamResponse(prompt) {\n const stream = await client.chat.completions.create({\n model: \"cc/claude-sonnet-4-20250514\",\n messages: [{ role: \"user\", content: prompt }],\n stream: true\n });\n\n for await (const chunk of stream) {\n const content = chunk.choices[0]?.delta?.content || \"\";\n process.stdout.write(content);\n }\n}\n\nstreamResponse(\"Write a short story about AI\");\n```\n\n### So sánh Nhiều Model\n\n```python\nfrom openai import OpenAI\n\nclient = OpenAI(\n api_key=\"your-api-key-from-dashboard\",\n base_url=\"http://localhost:20128/v1\"\n)\n\nmodels = [\n \"cc/claude-sonnet-4-20250514\",\n \"cx/deepseek-chat\",\n \"glm/glm-4-plus\"\n]\n\nprompt = \"Explain quantum computing in simple terms\"\n\nfor model in models:\n response = client.chat.completions.create(\n model=model,\n messages=[{\"role\": \"user\", \"content\": prompt}]\n )\n print(f\"\\n=== {model} ===\")\n print(response.choices[0].message.content)\n```\n\n## Pattern Tích hợp Phổ biến\n\n### Biến môi trường\n\nLưu credentials an toàn:\n\n```bash\n# .env file\nROUTER_API_KEY=your-api-key-from-dashboard\nROUTER_BASE_URL=http://localhost:20128/v1\nROUTER_MODEL=cc/claude-sonnet-4-20250514\n```\n\n```python\nimport os\nfrom openai import OpenAI\n\nclient = OpenAI(\n api_key=os.getenv(\"ROUTER_API_KEY\"),\n base_url=os.getenv(\"ROUTER_BASE_URL\")\n)\n```\n\n### Xử lý Lỗi\n\n```python\nfrom openai import OpenAI, OpenAIError\n\nclient = OpenAI(\n api_key=\"your-api-key\",\n base_url=\"http://localhost:20128/v1\"\n)\n\ntry:\n response = client.chat.completions.create(\n model=\"cc/claude-sonnet-4-20250514\",\n messages=[{\"role\": \"user\", \"content\": \"Hello\"}]\n )\n print(response.choices[0].message.content)\nexcept OpenAIError as e:\n print(f\"Error: {e}\")\n```\n\n### Logic Retry\n\n```python\nimport time\nfrom openai import OpenAI, RateLimitError\n\nclient = OpenAI(\n api_key=\"your-api-key\",\n base_url=\"http://localhost:20128/v1\"\n)\n\ndef chat_with_retry(prompt, max_retries=3):\n for attempt in range(max_retries):\n try:\n response = client.chat.completions.create(\n model=\"cc/claude-sonnet-4-20250514\",\n messages=[{\"role\": \"user\", \"content\": prompt}]\n )\n return response.choices[0].message.content\n except RateLimitError:\n if attempt < max_retries - 1:\n time.sleep(2 ** attempt) # Exponential backoff\n else:\n raise\n```\n\n## Troubleshooting\n\n### Vấn đề Connection\n\n**Vấn đề:** Không kết nối được đến 9Router\n```bash\n# Check if 9Router is running\ncurl http://localhost:20128/health\n\n# Expected response:\n{\"status\": \"ok\"}\n```\n\n**Giải pháp:**\n- Xác minh 9Router đang chạy\n- Kiểm tra port 20128 không bị chặn\n- Đảm bảo base URL đúng (bao gồm `/v1`)\n\n### Lỗi Xác thực\n\n**Vấn đề:** 401 Unauthorized\n```\nError: Invalid API key\n```\n\n**Giải pháp:**\n- Xác minh API key từ dashboard\n- Kiểm tra format header Authorization: `Bearer your-api-key`\n- Đảm bảo không có khoảng trắng hoặc xuống dòng thừa trong API key\n\n### Model Not Found\n\n**Vấn đề:** 404 Model not found\n```\nError: Model 'cc/claude-opus' not found\n```\n\n**Giải pháp:**\n- Dùng tên model chính xác (case-sensitive)\n- Kiểm tra model có sẵn: `curl http://localhost:20128/v1/models`\n- Xác minh model được bật trong plan của bạn\n\n### Vấn đề Timeout\n\n**Vấn đề:** Request timeout\n```\nError: Request timed out after 30s\n```\n\n**Giải pháp:**\n- Tăng timeout trong cấu hình client\n- Dùng model nhanh hơn cho task nhạy cảm về thời gian\n- Kiểm tra kết nối network đến 9Router\n\n### Rate Limiting\n\n**Vấn đề:** 429 Too Many Requests\n```\nError: Rate limit exceeded\n```\n\n**Giải pháp:**\n- Triển khai exponential backoff\n- Giảm tần suất request\n- Kiểm tra rate limit trong dashboard\n- Cân nhắc nâng cấp plan\n\n## Best Practices\n\n### Bảo mật\n- Lưu API key trong biến môi trường\n- Không bao giờ commit API key vào version control\n- Dùng HTTPS cho cloud deployment\n- Xoay API key định kỳ\n\n### Hiệu năng\n- Dùng model phù hợp với độ phức tạp task\n- Triển khai caching cho query lặp lại\n- Dùng streaming cho phản hồi dài\n- Batch request khi có thể\n\n### Xử lý Lỗi\n- Luôn triển khai try-catch block\n- Thêm logic retry với exponential backoff\n- Log lỗi để debug\n- Cung cấp cơ chế fallback\n\n### Tối ưu Chi phí\n- Chọn model tiết kiệm chi phí cho task đơn giản\n- Cache phản hồi khi phù hợp\n- Theo dõi usage trong dashboard\n- Đặt giới hạn request trong code\n\n## Bước tiếp theo\n\n- [Cấu hình Cursor](cursor.md) cho tích hợp IDE\n- [Setup Continue](continue.md) cho VSCode\n- [Khám phá CLI usage](../cli/basic-usage.md)\n- [Tìm hiểu về chọn model](../models/overview.md)\n- [API Reference](../api/reference.md)\n"}, "796421f929dba51fd634f9d64d510f9cdcb1c98e": {"t": 1785764983.8900242, "n": 8901, "h": "112ae36200ae684c", "c": "# Tích hợp các Công cụ khác\n\n9Router tương thích với mọi công cụ hỗ trợ format API OpenAI. Hướng dẫn này bao gồm pattern tích hợp tổng quát cho nhiều công cụ và ứng dụng tùy chỉnh.\n\n## Tổng quan\n\n9Router cung cấp API endpoint tương thích OpenAI hoạt động với:\n- Script và ứng dụng tùy chỉnh\n- API client và công cụ test\n- Công cụ CLI và utility\n- Tích hợp bên thứ ba\n- Framework phát triển\n\n## Pattern Setup Tổng quát\n\nMọi công cụ tương thích OpenAI có thể kết nối đến 9Router bằng các cài đặt sau:\n\n**9Router cục bộ:**\n```\nBase URL: http://localhost:20128/v1\nAPI Key: your-api-key-from-dashboard\nModel: any 9Router model (cc/*, cx/*, glm/*, etc.)\n```\n\n**9Router cloud:**\n```\nBase URL: https://9router.com/v1\nAPI Key: your-api-key-from-dashboard\nModel: any 9Router model (cc/*, cx/*, glm/*, etc.)\n```\n\n## Model có sẵn\n\n### Claude Models (Anthropic)\n- `cc/claude-opus-4-5-20251101`\n- `cc/claude-sonnet-4-20250514`\n- `cc/claude-haiku-4-20250514`\n\n### DeepSeek Models\n- `cx/deepseek-chat`\n- `cx/deepseek-reasoner`\n\n### GLM Models (Zhipu AI)\n- `glm/glm-4-plus`\n- `glm/glm-4-flash`\n\n## Ví dụ Tích hợp\n\n### Python với OpenAI SDK\n\n```python\nfrom openai import OpenAI\n\nclient = OpenAI(\n api_key=\"your-api-key-from-dashboard\",\n base_url=\"http://localhost:20128/v1\"\n)\n\nresponse = client.chat.completions.create(\n model=\"cc/claude-sonnet-4-20250514\",\n messages=[\n {\"role\": \"user\", \"content\": \"Hello, how are you?\"}\n ]\n)\n\nprint(response.choices[0].message.content)\n```\n\n### Node.js với OpenAI SDK\n\n```javascript\nimport OpenAI from \"openai\";\n\nconst client = new OpenAI({\n apiKey: \"your-api-key-from-dashboard\",\n baseURL: \"http://localhost:20128/v1\"\n});\n\nconst response = await client.chat.completions.create({\n model: \"cc/claude-sonnet-4-20250514\",\n messages: [\n { role: \"user\", content: \"Hello, how are you?\" }\n ]\n});\n\nconsole.log(response.choices[0].message.content);\n```\n\n### Lệnh cURL\n\n```bash\ncurl http://localhost:20128/v1/chat/completions \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-api-key-from-dashboard\" \\\n -d '{\n \"model\": \"cc/claude-sonnet-4-20250514\",\n \"messages\": [\n {\"role\": \"user\", \"content\": \"Hello, how are you?\"}\n ]\n }'\n```\n\n### HTTP Client (Postman, Insomnia)\n\n**Request:**\n```\nPOST http://localhost:20128/v1/chat/completions\n```\n\n**Headers:**\n```\nContent-Type: application/json\nAuthorization: Bearer your-api-key-from-dashboard\n```\n\n**Body:**\n```json\n{\n \"model\": \"cc/claude-sonnet-4-20250514\",\n \"messages\": [\n {\"role\": \"user\", \"content\": \"Hello, how are you?\"}\n ],\n \"temperature\": 0.7,\n \"max_tokens\": 1000\n}\n```\n\n### Tích hợp LangChain\n\n```python\nfrom langchain.chat_models import ChatOpenAI\nfrom langchain.schema import HumanMessage\n\nllm = ChatOpenAI(\n model_name=\"cc/claude-sonnet-4-20250514\",\n openai_api_key=\"your-api-key-from-dashboard\",\n openai_api_base=\"http://localhost:20128/v1\",\n temperature=0.7\n)\n\nmessages = [HumanMessage(content=\"Explain quantum computing\")]\nresponse = llm(messages)\nprint(response.content)\n```\n\n### Tích hợp LlamaIndex\n\n```python\nfrom llama_index.llms import OpenAI\n\nllm = OpenAI(\n model=\"cc/claude-sonnet-4-20250514\",\n api_key=\"your-api-key-from-dashboard\",\n api_base=\"http://localhost:20128/v1\"\n)\n\nresponse = llm.complete(\"What is machine learning?\")\nprint(response.text)\n```\n\n## Ví dụ Script Tùy chỉnh\n\n### Script Xử lý Batch\n\n```python\nimport openai\nimport json\n\nopenai.api_key = \"your-api-key-from-dashboard\"\nopenai.api_base = \"http://localhost:20128/v1\"\n\ndef process_batch(prompts, model=\"cx/deepseek-chat\"):\n results = []\n for prompt in prompts:\n response = openai.ChatCompletion.create(\n model=model,\n messages=[{\"role\": \"user\", \"content\": prompt}]\n )\n results.append({\n \"prompt\": prompt,\n \"response\": response.choices[0].message.content\n })\n return results\n\nprompts = [\n \"Explain AI in one sentence\",\n \"What is machine learning?\",\n \"Define neural networks\"\n]\n\nresults = process_batch(prompts)\nprint(json.dumps(results, indent=2))\n```\n\n### Xử lý Streaming Response\n\n```javascript\nimport OpenAI from \"openai\";\n\nconst client = new OpenAI({\n apiKey: \"your-api-key-from-dashboard\",\n baseURL: \"http://localhost:20128/v1\"\n});\n\nasync function streamResponse(prompt) {\n const stream = await client.chat.completions.create({\n model: \"cc/claude-sonnet-4-20250514\",\n messages: [{ role: \"user\", content: prompt }],\n stream: true\n });\n\n for await (const chunk of stream) {\n const content = chunk.choices[0]?.delta?.content || \"\";\n process.stdout.write(content);\n }\n}\n\nstreamResponse(\"Write a short story about AI\");\n```\n\n### So sánh Nhiều Model\n\n```python\nfrom openai import OpenAI\n\nclient = OpenAI(\n api_key=\"your-api-key-from-dashboard\",\n base_url=\"http://localhost:20128/v1\"\n)\n\nmodels = [\n \"cc/claude-sonnet-4-20250514\",\n \"cx/deepseek-chat\",\n \"glm/glm-4-plus\"\n]\n\nprompt = \"Explain quantum computing in simple terms\"\n\nfor model in models:\n response = client.chat.completions.create(\n model=model,\n messages=[{\"role\": \"user\", \"content\": prompt}]\n )\n print(f\"\\n=== {model} ===\")\n print(response.choices[0].message.content)\n```\n\n## Pattern Tích hợp Phổ biến\n\n### Biến môi trường\n\nLưu credentials an toàn:\n\n```bash\n# .env file\nROUTER_API_KEY=your-api-key-from-dashboard\nROUTER_BASE_URL=http://localhost:20128/v1\nROUTER_MODEL=cc/claude-sonnet-4-20250514\n```\n\n```python\nimport os\nfrom openai import OpenAI\n\nclient = OpenAI(\n api_key=os.getenv(\"ROUTER_API_KEY\"),\n base_url=os.getenv(\"ROUTER_BASE_URL\")\n)\n```\n\n### Xử lý Lỗi\n\n```python\nfrom openai import OpenAI, OpenAIError\n\nclient = OpenAI(\n api_key=\"your-api-key\",\n base_url=\"http://localhost:20128/v1\"\n)\n\ntry:\n response = client.chat.completions.create(\n model=\"cc/claude-sonnet-4-20250514\",\n messages=[{\"role\": \"user\", \"content\": \"Hello\"}]\n )\n print(response.choices[0].message.content)\nexcept OpenAIError as e:\n print(f\"Error: {e}\")\n```\n\n### Logic Retry\n\n```python\nimport time\nfrom openai import OpenAI, RateLimitError\n\nclient = OpenAI(\n api_key=\"your-api-key\",\n base_url=\"http://localhost:20128/v1\"\n)\n\ndef chat_with_retry(prompt, max_retries=3):\n for attempt in range(max_retries):\n try:\n response = client.chat.completions.create(\n model=\"cc/claude-sonnet-4-20250514\",\n messages=[{\"role\": \"user\", \"content\": prompt}]\n )\n return response.choices[0].message.content\n except RateLimitError:\n if attempt < max_retries - 1:\n time.sleep(2 ** attempt) # Exponential backoff\n else:\n raise\n```\n\n## Troubleshooting\n\n### Vấn đề Connection\n\n**Vấn đề:** Không kết nối được đến 9Router\n```bash\n# Check if 9Router is running\ncurl http://localhost:20128/health\n\n# Expected response:\n{\"status\": \"ok\"}\n```\n\n**Giải pháp:**\n- Xác minh 9Router đang chạy\n- Kiểm tra port 20128 không bị chặn\n- Đảm bảo base URL đúng (bao gồm `/v1`)\n\n### Lỗi Xác thực\n\n**Vấn đề:** 401 Unauthorized\n```\nError: Invalid API key\n```\n\n**Giải pháp:**\n- Xác minh API key từ dashboard\n- Kiểm tra format header Authorization: `Bearer your-api-key`\n- Đảm bảo không có khoảng trắng hoặc xuống dòng thừa trong API key\n\n### Model Not Found\n\n**Vấn đề:** 404 Model not found\n```\nError: Model 'cc/claude-opus' not found\n```\n\n**Giải pháp:**\n- Dùng tên model chính xác (case-sensitive)\n- Kiểm tra model có sẵn: `curl http://localhost:20128/v1/models`\n- Xác minh model được bật trong plan của bạn\n\n### Vấn đề Timeout\n\n**Vấn đề:** Request timeout\n```\nError: Request timed out after 30s\n```\n\n**Giải pháp:**\n- Tăng timeout trong cấu hình client\n- Dùng model nhanh hơn cho task nhạy cảm về thời gian\n- Kiểm tra kết nối network đến 9Router\n\n### Rate Limiting\n\n**Vấn đề:** 429 Too Many Requests\n```\nError: Rate limit exceeded\n```\n\n**Giải pháp:**\n- Triển khai exponential backoff\n- Giảm tần suất request\n- Kiểm tra rate limit trong dashboard\n- Cân nhắc nâng cấp plan\n\n## Best Practices\n\n### Bảo mật\n- Lưu API key trong biến môi trường\n- Không bao giờ commit API key vào version control\n- Dùng HTTPS cho cloud deployment\n- Xoay API key định kỳ\n\n### Hiệu năng\n- Dùng model phù hợp với độ phức tạp task\n- Triển khai caching cho query lặp lại\n- Dùng streaming cho phản hồi dài\n- Batch request khi có thể\n\n### Xử lý Lỗi\n- Luôn triển khai try-catch block\n- Thêm logic retry với exponential backoff\n- Log lỗi để debug\n- Cung cấp cơ chế fallback\n\n### Tối ưu Chi phí\n- Chọn model tiết kiệm chi phí cho task đơn giản\n- Cache phản hồi khi phù hợp\n- Theo dõi usage trong dashboard\n- Đặt giới hạn request trong code\n\n## Bước tiếp theo\n\n- [Cấu hình Cursor](cursor.md) cho tích hợp IDE\n- [Setup Continue](continue.md) cho VSCode\n- [Khám phá CLI usage](../cli/basic-usage.md)\n- [Tìm hiểu về chọn model](../models/overview.md)\n- [API Reference](../api/reference.md)\n"}}}} |