Documentation API

Guides d'intégration détaillés et référence API pour vous aider à intégrer rapidement les services API IA de TokenWorks

1Démarrage rapide

Utiliser l'API TokenWorks ne nécessite que trois étapes simples :

Créez un compte TokenWorks et connectez-vous à la console
Créez une clé API dans la console
Utilisez votre clé API pour appeler nos interfaces

Tip: Les nouveaux utilisateurs recevront un crédit d'essai gratuit après leur inscription, sans avoir à lier une carte de crédit pour commencer.

2URL de base

L'URL de base de l'API est la suivante, toutes les requêtes utilisent le protocole HTTPS :

text

https://www.token8341.com/v1

Endpoint de complétion de chat :

text

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

Note: Cet endpoint est entièrement compatible avec le format de l'interface Chat Completions d'OpenAI. Vous pouvez utiliser directement le SDK d'OpenAI pour l'appeler.

3Méthode d'authentification

TokenWorks utilise un jeton Bearer pour l'authentification API. Veuillez inclure votre clé API dans l'en-tête de la requête :

text

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

Vous pouvez créer et gérer vos clés sur la page « API Keys » de la console. Veuillez conserver votre clé API en toute sécurité et ne l'exposez pas dans des dépôts de code publics ou du code côté client.

4Liste des modèles pris en charge

ID du modèle	Nom du modèle	Fournisseur
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

D'autres modèles sont en cours d'intégration, veuillez suivre nos annonces de mise à jour.

5Exemples de code

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

6Explication des codes d'erreur

En cas d'échec d'une requête API, le code de statut HTTP et le message d'erreur correspondants sont renvoyés, au format suivant :

json

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

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