C
Hướng dẫn API Claude

Claude trên TokenHub — Model Anthropic tương thích OpenAI

Gọi các model Anthropic Claude thông qua endpoint /chat/completions hợp nhất của TokenHub. Định dạng request và response hoàn toàn tương thích OpenAI — không cần chuyển đổi SDK. Hỗ trợ streaming, dùng tool (function calling) và vision (nhập ảnh). Tính phí theo token dựa trên tier của model.

OpenAI-CompatibleStreamingTool UseVisionClaude 3 → 4.7Token-based

1Lấy API Key của bạn

  1. Truy cập tokenhub.store và đăng ký tài khoản (hỗ trợ đăng nhập GitHub / Google)
  2. Vào Dashboard → API Keys, nhấp "Create New Key"
  3. Vào Dashboard → Billing để nạp Credits (1 Credit = $1 USD)
  4. Sao chép API Key (định dạng: th-xxxxxxxxxxxx...)
⚠️ API Key chỉ hiển thị một lần khi được tạo. Hãy lưu trữ an toàn; nếu mất, hãy tạo mới.

2Tổng quan API

Base URL

https://tokenhub.store/api/v1

Xác thực

Gửi API Key trong header Authorization:

Header
Authorization: Bearer th-your-api-key

Endpoint (OpenAI-compatible)

POST
/chat/completions

Chat completion. Cùng schema với OpenAI /v1/chat/completions, bao gồm streaming, tool use, vision và JSON mode.

Bạn có thể tiếp tục dùng SDK openai chính thức — chỉ cần trỏ base_url sang TokenHub và dùng API key của TokenHub. Không cần thay đổi code nào khác.

3Model & Giá

Giá được tính theo 1 triệu tokens (USD). Chỉ tính phí cho các cuộc gọi thành công. Chấp nhận cả ID chuẩn và bí danh anthropic/*.

TầngModel IDInputOutputGhi chú
Opus 4.7anthropic/claude-opus-4-7$5.00$25.00Mới nhất, chất lượng reasoning & coding cao nhất.
Opus 4.6anthropic/claude-opus-4-6$5.00$25.00Mới nhất, chất lượng reasoning & coding cao nhất.
Sonnet 4.6anthropic/claude-sonnet-4-6$3.00$15.00Cân bằng giữa chất lượng và chi phí hàng đầu (mặc định khuyến nghị).
Haiku 4.5anthropic/claude-haiku-4-5$1.00$5.004-gen nhanh nhất và rẻ nhất; phù hợp cho QPS cao và phân loại.
Sonnet 4.5anthropic/claude-sonnet-4-5$3.00$15.00Mẫu đa năng thế hệ trước.
Opus 4.5anthropic/claude-opus-4-5$5.00$25.00Mới nhất, chất lượng reasoning & coding cao nhất.
Sonnet 4anthropic/claude-4-sonnet$3.00$15.00Mẫu đa năng thế hệ trước.
Opus 4anthropic/claude-4-opus$15.00$75.00Mới nhất, chất lượng reasoning & coding cao nhất.
3.5 Sonnetanthropic/claude-3-5-sonnet-latest$3.00$15.00Ổn định, đã được kiểm chứng trong production; tương thích rộng rãi.
3.5 Haikuanthropic/claude-3-5-haiku-latest$0.80$4.00Ổn định, đã được kiểm chứng trong production; tương thích rộng rãi.

4Tham số yêu cầu

Tham sốKiểuBắt buộcMặc địnhMô tả
modelstringBắt buộcID model Claude. Ví dụ: "anthropic/claude-sonnet-4-6". Chấp nhận cả dạng có tiền tố anthropic/* và tên rút gọn.
messagesarrayBắt buộcLịch sử chat. Mỗi mục là { role, content }. role ∈ system | user | assistant. content là một chuỗi hoặc một mảng các phần (cho vision / kết quả tool).
max_tokensintegerTùy chọn1024Số tokens đầu ra tối đa (Claude yêu cầu tham số này). Thường là 1024–4096.
temperaturenumberTùy chọn1.0Sampling temperature, 0.0–1.0. Càng thấp = càng quyết định hơn.
top_pnumberTùy chọn1.0Nucleus sampling. Dùng temperature HOẶC top_p, không dùng cả hai.
streambooleanTùy chọnfalseNếu true, trả về các delta dạng Server-Sent Events (SSE).
stopstring[]Tùy chọnTối đa 4 chuỗi dừng.
toolsarrayTùy chọnDanh sách định nghĩa tool/function cho tool use (function calling).
tool_choicestring|objectTùy chọnautoĐiều khiển lựa chọn tool: auto | none | required | { type:'function', function:{ name } }.
response_formatobjectTùy chọnJSON mode: { "type": "json_object" } buộc model trả về JSON hợp lệ.
userstringTùy chọnID người dùng cuối tùy chọn để bạn theo dõi nội bộ.

5Ví dụ curl

bash
curl https://tokenhub.store/api/v1/chat/completions \
  -H "Authorization: Bearer th-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-6",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Explain CAP theorem in 3 bullets."}
    ],
    "max_tokens": 512,
    "temperature": 0.3
  }'

6Ví dụ Python

python
from openai import OpenAI

client = OpenAI(
    api_key="th-your-api-key",
    base_url="https://tokenhub.store/api/v1",
)

resp = client.chat.completions.create(
    model="anthropic/claude-sonnet-4-6",
    max_tokens=512,
    temperature=0.3,
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "Explain CAP theorem in 3 bullets."},
    ],
)

print(resp.choices[0].message.content)
print("usage:", resp.usage)

7Ví dụ JavaScript / Node.js

javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "th-your-api-key",
  baseURL: "https://tokenhub.store/api/v1",
});

const resp = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-4-6",
  max_tokens: 512,
  temperature: 0.3,
  messages: [
    { role: "system", content: "You are a concise assistant." },
    { role: "user", content: "Explain CAP theorem in 3 bullets." },
  ],
});

console.log(resp.choices[0].message.content);
console.log("usage:", resp.usage);

8Mẹo sử dụng

  • Luôn đặt max_tokens — Claude xem đây là trường bắt buộc về mặt ngữ nghĩa. Nếu không có, các lượt sinh dài có thể bị cắt sớm hơn mong đợi.
  • Đặt hướng dẫn trong một system message duy nhất; giữ các lượt user tập trung. Claude tuân theo system prompts rất mạnh.
  • Để trích xuất có cấu trúc, hãy kết hợp system prompt như 'Chỉ trả về JSON' với response_format: { type: 'json_object' }.
  • Streaming cải thiện đáng kể độ trễ cảm nhận trên các phản hồi dài. Định dạng delta khớp chính xác với OpenAI.
  • Haiku-4-5 rẻ hơn khoảng 5× so với Sonnet-4-6 nhưng vẫn có năng lực tương tự cho các tác vụ ngắn — hãy chuyển các truy vấn đơn giản sang Haiku để tiết kiệm chi phí.
  • Vision: truyền ảnh dưới dạng { type: 'image_url', image_url: { url: 'https://...' } } trong mảng content. Data URI (base64) cũng được hỗ trợ.

9FAQ

Sẵn sàng bắt đầu?

Đăng ký TokenHub và bắt đầu gọi Claude qua OpenAI-compatible API của chúng tôi