เอกสาร API
คำแนะนำการเชื่อมต่อโดยละเอียดและเอกสารอ้างอิง API เพื่อช่วยให้คุณรวมบริการ TokenWorks AI API ได้อย่างรวดเร็ว
1เริ่มต้นใช้งาน
ใช้ TokenWorks API เพียง 3 ขั้นตอนง่ายๆ:
- ลงทะเบียนบัญชี TokenWorks และเข้าสู่ระบบคอนโซล
- สร้าง API Key ในคอนโซล
- ใช้ API Key ของคุณเพื่อเรียกใช้ API ของเรา
Tip: ผู้ใช้ใหม่จะได้รับเครดิตทดลองใช้ฟรีหลังลงทะเบียน โดยไม่ต้องผูกบัตรเครดิตเพื่อเริ่มใช้งาน
2ที่อยู่ API
ที่อยู่พื้นฐานของ API มีดังนี้ ทุกคำขอใช้โปรโตคอล HTTPS:
https://www.token8341.com/v1อินเทอร์เฟซ Chat Completion:
POST https://www.token8341.com/v1/chat/completionsNote: อินเทอร์เฟซนี้เข้ากันได้อย่างสมบูรณ์กับรูปแบบอินเทอร์เฟซ Chat Completions ของ OpenAI คุณสามารถใช้ OpenAI SDK เพื่อเรียกใช้ได้โดยตรง
3วิธีการยืนยันตัวตน
TokenWorks ใช้ Bearer Token สำหรับการยืนยันตัวตน API โปรดนำ API Key ของคุณในส่วนหัวของคำขอ:
Authorization: Bearer sk-your-api-key-hereคุณสามารถสร้างและจัดการคีย์ของคุณได้ที่หน้า «API Keys» ในคอนโซล โปรดเก็บ API Key ของคุณอย่างปลอดภัย อย่าเปิดเผยในที่เก็บโค้ดสาธารณะหรือโค้ดฝั่งไคลเอนต์
4รายการโมเดลที่รองรับ
| รหัสโมเดล | ชื่อโมเดล | ผู้ให้บริการ |
|---|---|---|
| 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 | |
| deepseek-v4-pro | DeepSeek-V4-Pro | DeepSeek |
| qwen-max | Qwen-Max | Alibaba Cloud |
กำลังเพิ่มโมเดลเพิ่มเติมอย่างต่อเนื่อง โปรดติดตามประกาศอัปเดตของเรา
5โค้ดตัวอย่าง
curl
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)
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)
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);6คำอธิบายรหัสข้อผิดพลาด
เมื่อคำขอ API ล้มเหลว จะส่งคืนรหัสสถานะ HTTP และข้อความข้อผิดพลาดที่เกี่ยวข้อง รูปแบบดังนี้:
{
"error": {
"message": "Insufficient balance",
"type": "insufficient_balance",
"code": 402
}
}| รหัสสถานะ | ชื่อ | คำอธิบาย |
|---|---|---|
| 400 | Bad Request | 请求参数错误,请检查请求体格式 |
| 401 | Unauthorized | API Key 无效或缺失,请检查 Authorization 请求头 |
| 402 | Insufficient Balance | 账户余额不足,请充值后重试 |
| 404 | Not Found | 请求的模型或接口不存在 |
| 429 | Rate Limit | 请求频率过高,请稍后重试 |
| 500 | Internal Server Error | 服务内部错误,请联系技术支持 |
| 503 | Service Unavailable | 模型服务暂时不可用,请稍后重试 |