Bắt Đầu Nhanh

URL Cơ Sở API

TokSpan hỗ trợ nhiều giao thức API. Chọn giao thức SDK của bạn đã dùng — mọi định dạng đều chấp nhận cùng một khóa và truy cập hơn 200 mô hình.

Tương thích OpenAI

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tokspan.com/v1",  # ← OpenAI-compatible base URL
)

response = client.chat.completions.create(
    model="MODEL_NAME",  # Replace MODEL_NAME with any model from the catalog
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)

Anthropic Gốc

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-api-key",
    base_url="https://api.tokspan.com",  # ← Native Anthropic base URL (host root; SDK appends /v1/messages)
)

response = client.messages.create(
    model="MODEL_NAME",  # Replace MODEL_NAME with any Claude model from the catalog
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.content[0].text)

Tương thích Gemini

from google import genai

client = genai.Client(
    api_key="sk-your-api-key",
    http_options=genai.types.HttpOptions(
        base_url="https://api.tokspan.com/v1beta",  # ← Gemini base URL
    ),
)

response = client.models.generate_content(
    model="MODEL_NAME",  # Replace MODEL_NAME with any Gemini model from the catalog
    contents="Hello!",
)

print(response.text)

Responses API

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tokspan.com/v1",  # ← Same base URL as OpenAI-compatible
)

response = client.responses.create(
    model="MODEL_NAME",  # Replace MODEL_NAME with any model from the catalog
    input="Hello!",
)

print(response.output_text)

Sử dụng TokSpan API

Không cần SDK — gửi yêu cầu trực tiếp đến endpoint tương thích OpenAI bằng HTTP thuần:

Tất cả yêu cầu sử dụng cùng định dạng: POST https://api.tokspan.com/v1/chat/completions với khóa API của bạn trong header Authorization.

import requests

def chat(prompt: str, model: str = "MODEL_NAME"):  # Replace MODEL_NAME with any model from the catalog
    response = requests.post(
        "https://api.tokspan.com/v1/chat/completions",
        headers={
            "Authorization": "Bearer sk-your-api-key",
            "Content-Type": "application/json",
        },
        json={
            "model": model,
            "messages": [{"role": "user", "content": prompt}],
        },
    )
    return response.json()["choices"][0]["message"]["content"]

print(chat("Hello! What models are available?"))

const chat = async (prompt: string, model = 'MODEL_NAME') => {  // Replace MODEL_NAME with any model from the catalog
  const res = await fetch('https://api.tokspan.com/v1/chat/completions', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk-your-api-key',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model,
      messages: [{ role: 'user', content: prompt }],
    }),
  });
  const data = await res.json();
  return data.choices[0].message.content;
};

curl -X POST "https://api.tokspan.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Chuyển Đổi Định Dạng Chéo

TokSpan tự động chuyển đổi giữa các định dạng API khác nhau ở phía sau. Bạn luôn gửi yêu cầu theo định dạng OpenAI Chat Completions — TokSpan xử lý việc chuyển đổi sang định dạng gốc của nhà cung cấp ngược dòng:

• OpenAI → Claude Messages API — System prompt, hội thoại nhiều lượt và định nghĩa công cụ được ánh xạ lại tự động
• OpenAI → Gemini API — Phần nội dung, cài đặt an toàn và cấu hình tạo được chuyển đổi minh bạch
• Claude → định dạng OpenAI — Phản hồi gốc của Claude được chuẩn hóa về cấu trúc phản hồi Chat Completions tiêu chuẩn

Điều này có nghĩa là bạn có thể sử dụng OpenAI Python/Node SDK, LangChain hoặc bất kỳ thư viện tương thích OpenAI nào để gọi bất kỳ mô hình nào — bất kể định dạng API gốc của nó.

Phạm Vi & Quyền Của Khóa

Mỗi khóa API có thể được giới hạn phạm vi với các quyền cụ thể:

• Mô Hình: Giới hạn những mô hình mà khóa có thể truy cập
• Giới hạn chi tiêu: Đặt hạn mức cứng — khóa tự động bị vô hiệu hóa khi hết hạn mức
• Giới hạn IP: Chỉ cho phép yêu cầu từ các dải IP cụ thể

Tiếp Theo Là Gì?

• Duyệt danh mục mô hình đầy đủ — hơn 200 mô hình trên 50+ nhà cung cấp
• Tìm hiểu về tự động chuyển đổi dự phòng cho độ bền production
• Khám phá tích hợp SDK cho Python, JavaScript và hơn thế nữa
• Đọc tham khảo Chat Completions API cho tất cả tham số