> ## Documentation Index > Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt > Use this file to discover all available pages before exploring further. # ✨ API Đa Định dạng > Sử dụng định dạng OpenAI, Anthropic hoặc Gemini với một khóa API duy nhất ## Tổng quan TokenLab hỗ trợ **ba định dạng API gốc** với một khóa API duy nhất. Chọn định dạng phù hợp nhất với trường hợp sử dụng của bạn — không cần thay đổi cấu hình. `/v1/chat/completions` Định dạng tiêu chuẩn, tương thích rộng nhất `/v1/messages` Tư duy mở rộng, các tính năng Claude nguyên gốc `/v1beta/models/:model:generateContent` Tích hợp hệ sinh thái Google ## Tại sao hỗ trợ đa định dạng? | Lợi ích | Mô tả | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | **No SDK switching** | Sử dụng bất kỳ mô hình nào với SDK bạn ưa thích | | **Native features** | Truy cập các khả năng riêng theo định dạng | | **Di chuyển ưu tiên gốc** | Giữ các tuyến gốc của nhà cung cấp khi hành vi là quan trọng; dùng khả năng tương thích OpenAI `/v1` cho các client kiểu OpenAI hiện có | | **Single billing** | Một tài khoản, một khóa API, tất cả các định dạng | ## So sánh định dạng | Tính năng | OpenAI | Anthropic | Gemini | | --------------------- | ----------------------- | -------------------------- | --------------------------------------- | | **Endpoint** | `/v1/chat/completions` | `/v1/messages` | `/v1beta/models/:model:generateContent` | | **Tiêu đề xác thực** | `Authorization: Bearer` | `x-api-key` | `Authorization: Bearer` | | **System Prompt** | Trong mảng `messages` | Trường `system` riêng biệt | Trong `systemInstruction` | | **Extended Thinking** | ❌ | ✅ | ❌ | | **Phát trực tuyến** | ✅ SSE | ✅ SSE | ✅ SSE | | **Gọi công cụ** | ✅ | ✅ | ✅ | | **Vision** | ✅ | ✅ | ✅ | ## Định dạng OpenAI Hãy dùng tuyến tương thích này cho các tích hợp OpenAI SDK hiện có và các luồng chat hoặc embedding di động. Với hành vi gốc của Claude hoặc Gemini, hãy dùng định dạng Anthropic hoặc Gemini bên dưới. ```python theme={null} from openai import OpenAI client = OpenAI( api_key="sk-your-tokenlab-key", base_url="https://api.tokenlab.sh/v1" ) # Portable chat works across many models response = client.chat.completions.create( model="claude-sonnet-4-6", # Claude via OpenAI format messages=[ {"role": "system", "content": "You are a helpful assistant."}, {"role": "user", "content": "Hello!"} ] ) ``` **Phù hợp cho:** * Sử dụng chung * Các tích hợp hiện có với OpenAI SDK * Tương thích tối đa ## Định dạng Anthropic API Messages gốc của Anthropic. Cần thiết cho các tính năng riêng của Claude như tư duy mở rộng. ```python theme={null} from anthropic import Anthropic client = Anthropic( api_key="sk-your-tokenlab-key", base_url="https://api.tokenlab.sh" # No /v1 suffix! ) message = client.messages.create( model="claude-sonnet-4-6", max_tokens=1024, system="You are a helpful assistant.", # Separate system field messages=[ {"role": "user", "content": "Hello!"} ] ) ``` ### Tư duy mở rộng (Claude Opus 4.6) Chỉ có sẵn ở định dạng Anthropic: ```python theme={null} message = client.messages.create( model="claude-opus-4-6", max_tokens=16000, thinking={ "type": "enabled", "budget_tokens": 10000 }, messages=[{"role": "user", "content": "Solve this complex problem..."}] ) # Access thinking process for block in message.content: if block.type == "thinking": print(f"Thinking: {block.thinking}") elif block.type == "text": print(f"Answer: {block.text}") ``` **Phù hợp cho:** * Các tính năng riêng của Claude * Chế độ tư duy mở rộng * Người dùng Anthropic SDK gốc ## Định dạng Gemini Định dạng API Gemini gốc của Google để tích hợp trong hệ sinh thái Google. ```bash theme={null} curl "https://api.tokenlab.sh/v1beta/models/gemini-3.5-flash:generateContent" \ -H "Authorization: Bearer sk-your-tokenlab-key" \ -H "Content-Type: application/json" \ -d '{ "contents": [{ "parts": [{"text": "Hello!"}] }], "systemInstruction": { "parts": [{"text": "You are a helpful assistant."}] } }' ``` ### Phát luồng ```bash theme={null} curl "https://api.tokenlab.sh/v1beta/models/gemini-3.5-flash:streamGenerateContent?alt=sse" \ -H "Authorization: Bearer sk-your-tokenlab-key" \ -H "Content-Type: application/json" \ -d '{ "contents": [{"parts": [{"text": "Write a story"}]}] }' ``` **Phù hợp cho:** * Tích hợp Google Cloud * Mã nguồn sẵn có với Gemini SDK * Các tính năng gốc của Gemini **Gemini Files và Cache:** Tuyến Gemini gốc hỗ trợ `/upload/v1beta/files`, `/v1beta/files`, `/v1beta/files:register` và `/v1beta/cachedContents`. Files dùng các kênh upstream tương thích Gemini File API; tài nguyên Cache tường minh cũng có thể đi qua kênh Vertex AI. Tài nguyên tạo qua TokenLab được gắn với cùng channel/key upstream cho các lần gọi `generateContent` sau đó. ## Ranh giới tương thích công cụ Công cụ hàm có thể được chuyển đổi giữa các định dạng khi tuyến đích hỗ trợ. Công cụ gốc của nhà cung cấp phải ở lại tuyến gốc của nó: * Công cụ hosted và native của OpenAI Responses như `tool_search`, `web_search`, `file_search`, `code_interpreter`, MCP, shell/apply\_patch và công cụ computer-use cần `/v1/responses`. * Công cụ server/native của Anthropic như `web_search_*`, `web_fetch_*`, `code_execution_*`, `tool_search_*`, bash, computer-use và text-editor cần `/v1/messages`. * Công cụ tích hợp của Gemini như `googleSearch`, `codeExecution`, `urlContext`, `computerUse` và các trường `tools` tương tự cần `/v1beta`. Nếu TokenLab không thể định tuyến yêu cầu có công cụ native tới một đường upstream hỗ trợ định dạng native, hệ thống sẽ trả lỗi unsupported-field rõ ràng thay vì âm thầm bỏ công cụ hoặc giả vờ đó là hàm Chat Completions. Công cụ hàm do người dùng định nghĩa vẫn là đường công cụ dễ di chuyển nhất. ## Chọn định dạng phù hợp ```mermaid theme={null} graph TD A[Which format?] --> B{Need Claude extended thinking?} B -->|Yes| C[Use Anthropic Format] B -->|No| D{Existing codebase?} D -->|OpenAI SDK| E[Use OpenAI Format] D -->|Anthropic SDK| C D -->|Gemini SDK| F[Use Gemini Format] D -->|Dự án mới| G{Cần hành vi native của provider?} G -->|Yes| H[Use native Anthropic or Gemini Format] G -->|No| E ``` ## Hướng dẫn chuyển đổi ### Từ API chính thức của OpenAI ```python theme={null} # Before (OpenAI) client = OpenAI(api_key="sk-openai-key") # After (TokenLab) client = OpenAI( api_key="sk-tokenlab-key", base_url="https://api.tokenlab.sh/v1" # Add this line ) # That's it! Same code works ``` ### Từ API chính thức của Anthropic ```python theme={null} # Before (Anthropic) client = Anthropic(api_key="sk-ant-key") # After (TokenLab) client = Anthropic( api_key="sk-tokenlab-key", base_url="https://api.tokenlab.sh" # Add this line (no /v1!) ) ``` ### Từ Google AI Studio ```python theme={null} # Before (Google) import google.generativeai as genai genai.configure(api_key="google-api-key") # After (TokenLab) - Use REST API import requests response = requests.post( "https://api.tokenlab.sh/v1beta/models/gemini-3.5-flash:generateContent", headers={"Authorization": "Bearer sk-tokenlab-key"}, json={"contents": [{"parts": [{"text": "Hello"}]}]} ) ``` ## Tương thích đa mô hình Sức mạnh của TokenLab: sử dụng **bất kỳ SDK nào** với **bất kỳ mô hình nào**. Cổng sẽ tự động xử lý việc chuyển đổi định dạng. ### Bất kỳ SDK → Bất kỳ mô hình ```python theme={null} # Anthropic SDK with GPT-4o (auto-converts to OpenAI format) from anthropic import Anthropic client = Anthropic( api_key="sk-tokenlab-key", base_url="https://api.tokenlab.sh" ) response = client.messages.create( model="gpt-4o", # ✅ Works! Auto-converted max_tokens=1024, messages=[{"role": "user", "content": "Hello!"}] ) # Same compatibility SDK for portable chat; native-only features still need native routes response = client.messages.create(model="gemini-3.5-flash", ...) # ✅ Works! response = client.messages.create(model="deepseek-r1", ...) # ✅ Works! ``` ### OpenAI SDK → Tất cả các mô hình ```python theme={null} from openai import OpenAI client = OpenAI(base_url="https://api.tokenlab.sh/v1", api_key="sk-...") # These portable chat calls use the same /v1 compatibility SDK: response = client.chat.completions.create(model="gpt-4o", ...) response = client.chat.completions.create(model="claude-sonnet-4-6", ...) response = client.chat.completions.create(model="gemini-3.5-flash", ...) ``` ### So sánh giữa các nhà cung cấp | Nền tảng | Định dạng OpenAI | Định dạng Anthropic | Định dạng Gemini | Responses API | | ------------ | :--------------: | :-----------------: | :--------------: | :--------------: | | **TokenLab** | ✅ Tất cả mô hình | ✅ Tất cả mô hình | ✅ Tất cả mô hình | ✅ Tất cả mô hình | | OpenRouter | ✅ Tất cả mô hình | ❌ | ❌ | ❌ | | Together AI | ✅ Tất cả mô hình | ❌ | ❌ | ❌ | | Fireworks | ✅ Tất cả mô hình | ❌ | ❌ | ❌ | Mặc dù chuyển đổi giữa các định dạng hoạt động với hầu hết các tính năng, các tính năng đặc thù theo định dạng (như tính năng tư duy mở rộng của Anthropic) yêu cầu sử dụng định dạng gốc.