TokenWorks

เอกสาร API

คำแนะนำการเชื่อมต่อโดยละเอียดและเอกสารอ้างอิง API เพื่อช่วยให้คุณรวมบริการ TokenWorks AI API ได้อย่างรวดเร็ว

1เริ่มต้นใช้งาน

ใช้ TokenWorks API เพียง 3 ขั้นตอนง่ายๆ:

  1. ลงทะเบียนบัญชี TokenWorks และเข้าสู่ระบบคอนโซล
  2. สร้าง API Key ในคอนโซล
  3. ใช้ API Key ของคุณเพื่อเรียกใช้ API ของเรา

Tip: ผู้ใช้ใหม่จะได้รับเครดิตทดลองใช้ฟรีหลังลงทะเบียน โดยไม่ต้องผูกบัตรเครดิตเพื่อเริ่มใช้งาน

2ที่อยู่ API

ที่อยู่พื้นฐานของ API มีดังนี้ ทุกคำขอใช้โปรโตคอล HTTPS:

text
https://www.token8341.com/v1

อินเทอร์เฟซ Chat Completion:

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

Note: อินเทอร์เฟซนี้เข้ากันได้อย่างสมบูรณ์กับรูปแบบอินเทอร์เฟซ Chat Completions ของ OpenAI คุณสามารถใช้ OpenAI SDK เพื่อเรียกใช้ได้โดยตรง

3วิธีการยืนยันตัวตน

TokenWorks ใช้ Bearer Token สำหรับการยืนยันตัวตน API โปรดนำ API Key ของคุณในส่วนหัวของคำขอ:

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

คุณสามารถสร้างและจัดการคีย์ของคุณได้ที่หน้า «API Keys» ในคอนโซล โปรดเก็บ API Key ของคุณอย่างปลอดภัย อย่าเปิดเผยในที่เก็บโค้ดสาธารณะหรือโค้ดฝั่งไคลเอนต์

4รายการโมเดลที่รองรับ

รหัสโมเดลชื่อโมเดลผู้ให้บริการ
gpt-4oGPT-4oOpenAI
gpt-4o-miniGPT-4o MiniOpenAI
claude-3-5-sonnetClaude 3.5 SonnetAnthropic
claude-4-sonnetClaude 4 SonnetAnthropic
gemini-2-0-proGemini 2.0 ProGoogle
deepseek-v4-proDeepSeek-V4-ProDeepSeek
qwen-maxQwen-MaxAlibaba Cloud

กำลังเพิ่มโมเดลเพิ่มเติมอย่างต่อเนื่อง โปรดติดตามประกาศอัปเดตของเรา

5โค้ดตัวอย่าง

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);

6คำอธิบายรหัสข้อผิดพลาด

เมื่อคำขอ API ล้มเหลว จะส่งคืนรหัสสถานะ HTTP และข้อความข้อผิดพลาดที่เกี่ยวข้อง รูปแบบดังนี้:

json
{
  "error": {
    "message": "Insufficient balance",
    "type": "insufficient_balance",
    "code": 402
  }
}
รหัสสถานะชื่อคำอธิบาย
400Bad Request请求参数错误,请检查请求体格式
401UnauthorizedAPI Key 无效或缺失,请检查 Authorization 请求头
402Insufficient Balance账户余额不足,请充值后重试
404Not Found请求的模型或接口不存在
429Rate Limit请求频率过高,请稍后重试
500Internal Server Error服务内部错误,请联系技术支持
503Service Unavailable模型服务暂时不可用,请稍后重试