API-documentatie

Gedetailleerde integratiegids en API-referentie om u te helpen snel TokenWorks AI API-services te integreren

1Snel starten

Het gebruik van de TokenWorks API vereist slechts drie eenvoudige stappen:

Registreer een TokenWorks-account en log in op de console
Maak een API Key aan in de console
Gebruik uw API Key om onze interfaces aan te roepen

Tip: Nieuwe gebruikers ontvangen na registratie een gratis proefquotum, zonder dat een creditcard nodig is om te beginnen.

2Interface-URL

De basis-URL van de API is als volgt, alle verzoeken gebruiken het HTTPS-protocol:

text

https://www.token8341.com/v1

Chat-aanvullingsinterface:

text

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

Note: Deze interface is volledig compatibel met het Chat Completions-interfaceformaat van OpenAI. U kunt rechtstreeks de SDK van OpenAI gebruiken om aan te roepen.

3Authenticatiemethode

TokenWorks gebruikt Bearer Token voor API-authenticatie. Neem uw API Key op in de request-header:

text

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

U kunt uw sleutels aanmaken en beheren op de pagina 'API Keys' in de console. Bewaar uw API Key zorgvuldig en stel deze niet bloot in openbare code-repositories of clientcode.

4Lijst met ondersteunde modellen

Model-ID	Modelnaam	Leverancier
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

Er worden voortdurend meer modellen toegevoegd. Houd onze updatemeldingen in de gaten.

5Voorbeeldcode

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

6Uitleg foutcodes

Wanneer een API-verzoek mislukt, worden de bijbehorende HTTP-statuscode en foutinformatie geretourneerd, in het volgende formaat:

json

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

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