Tài liệu API

Hướng dẫn tích hợp chi tiết và tài liệu tham khảo API, giúp bạn nhanh chóng tích hợp dịch vụ API AI của TokenWorks

1Bắt đầu nhanh

Sử dụng API TokenWorks chỉ cần ba bước đơn giản:

Đăng ký tài khoản TokenWorks và đăng nhập bảng điều khiển
Tạo API Key trong bảng điều khiển
Sử dụng API Key của bạn để gọi các giao diện của chúng tôi

Tip: Người dùng mới đăng ký sẽ nhận được hạn mức dùng thử miễn phí, không cần liên kết thẻ tín dụng để bắt đầu sử dụng.

2Địa chỉ giao diện

Địa chỉ cơ sở của API như sau, tất cả các yêu cầu đều sử dụng giao thức HTTPS:

text

https://www.token8341.com/v1

Giao diện hoàn thiện hội thoại:

text

POST https://www.token8341.com/v1/chat/completions

Note: Giao diện này hoàn toàn tương thích với định dạng giao diện Chat Completions của OpenAI, bạn có thể trực tiếp sử dụng SDK của OpenAI để gọi.

3Phương thức xác thực

TokenWorks sử dụng Bearer Token để xác thực API. Vui lòng mang theo API Key của bạn trong tiêu đề yêu cầu:

text

Authorization: Bearer sk-your-api-key-here

Bạn có thể tạo và quản lý khóa của mình tại trang "API Keys" trong bảng điều khiển. Vui lòng bảo quản API Key của bạn cẩn thận, không tiết lộ trong kho mã công khai hoặc mã phía máy khách.

4Danh sách mô hình hỗ trợ

ID mô hình	Tên mô hình	Nhà cung cấp
gpt-4o	GPT-4o	OpenAI
gpt-4o-mini	GPT-4o Mini	OpenAI
claude-3-5-sonnet	Claude 3.5 Sonnet	Anthropic
claude-4-sonnet	Claude 4 Sonnet	Anthropic
gemini-2-0-pro	Gemini 2.0 Pro	Google
deepseek-v4-pro	DeepSeek-V4-Pro	DeepSeek
qwen-max	Qwen-Max	Alibaba Cloud

Nhiều mô hình hơn đang được tích hợp liên tục, vui lòng theo dõi thông báo cập nhật của chúng tôi.

5Mã mẫu

curl

bash

curl https://www.token8341.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

Python (openai SDK)

python

from openai import OpenAI

client = OpenAI(
    base_url="https://www.token8341.com/v1",
    api_key="sk-your-api-key-here"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

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

Node.js (openai SDK)

javascript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://www.token8341.com/v1",
  apiKey: "sk-your-api-key-here",
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    { role: "user", content: "Hello!" },
  ],
});

console.log(response.choices[0].message.content);

6Giải thích mã lỗi

Khi yêu cầu API thất bại, sẽ trả về mã trạng thái HTTP và thông tin lỗi tương ứng, định dạng như sau:

json

{
  "error": {
    "message": "Insufficient balance",
    "type": "insufficient_balance",
    "code": 402
  }
}

Mã trạng thái	Tên	Mô tả
400	Bad Request	请求参数错误，请检查请求体格式
401	Unauthorized	API Key 无效或缺失，请检查 Authorization 请求头
402	Insufficient Balance	账户余额不足，请充值后重试
404	Not Found	请求的模型或接口不存在
429	Rate Limit	请求频率过高，请稍后重试
500	Internal Server Error	服务内部错误，请联系技术支持
503	Service Unavailable	模型服务暂时不可用，请稍后重试