SiCore TokenWorks

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 SiCore TokenWorks

1Démarrage rapide

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

  1. Créez un compte SiCore TokenWorks et connectez-vous à la console
  2. Créez une clé API dans la console
  3. 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

SiCore 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èleNom du modèleFournisseur
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

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

Questions fréquentes sur l'intégration

Questions fréquentes sur les API Key, le changement de modèle et les langages d'intégration

Une seule API Key permet-elle d'appeler tous les modèles ?

Oui. C'est la caractéristique principale de SiCore TokenWorks — les développeurs n'ont besoin de s'intégrer qu'une seule fois pour appeler tous les modèles de la plateforme, sans avoir à créer de compte ni à gérer de Key séparément pour chaque fournisseur.

Faut-il modifier le code pour changer de modèle ?

Aucune modification de la logique du code n'est nécessaire : il suffit de changer le paramètre model ID pour basculer entre les modèles nationaux et internationaux.

Quels langages de programmation sont pris en charge ?

Des exemples d'intégration pour cURL, Python, Node.js et d'autres langages courants sont fournis, compatibles avec tout langage prenant en charge les requêtes HTTP ainsi qu'avec le SDK officiel OpenAI.

Comment l'API est-elle authentifiée ?

L'authentification se fait par Bearer Token, il suffit d'inclure la API Key dans l'en-tête de la requête ; l'interface est entièrement compatible avec le format Chat Completions d'OpenAI, et peut être appelée directement avec le SDK officiel d'OpenAI, sans adaptation supplémentaire.

Existe-t-il des SDK ou des exemples de code prêts à l'emploi ?

Oui. La plateforme fournit des exemples d'intégration pour cURL, Python, Node.js et autres langages courants ; les développeurs peuvent choisir selon leur langage pour une intégration rapide.

Les modèles vont-ils continuer à s'ajouter ? Faut-il modifier le code pour les nouveaux modèles ?

Oui. La plateforme intègre en continu de nouveaux modèles nationaux et internationaux majeurs, avec un mode d'intégration et un système de facturation uniformes ; après la mise en ligne d'un nouveau modèle, il est possible de l'utiliser directement sans modifier le code.

Comment utiliser le mécanisme de cache de l'API des grands modèles ? Dans quels scénarios le cache est-il activé ?

La plateforme utilise un cache partagé entre utilisateurs pour un même prompt ; une fois le cache activé, le prix baisse de plus de 90 %, le prix avec cache atteignant au minimum ¥0.010 / million de Token, la partie en cache étant facturée au tarif du cache. Cela convient aux scénarios où plusieurs utilisateurs réutilisent un même prompt de préfixe, par exemple un prompt système fixe, un préfixe de connaissances communes, etc. — placez la partie invariante en premier pour obtenir un meilleur taux de succès du cache.

En cas d'échec ou de timeout d'un appel API, comment mettre en place la relance automatique et la dégradation ?

L'approche habituelle est la suivante : appliquer une relance avec backoff exponentiel pour les timeouts et les erreurs réessayables, avec un nombre maximal de tentatives ; en cas d'échec persistant, basculer vers un modèle de secours. Sur la plateforme, changer de modèle ne nécessite que de modifier l'ID du modèle, sans aucune modification du code : il suffit d'indiquer un autre ID de modèle comme cible de dégradation. La plateforme dispose également d'une redondance multi-nœuds et d'un routage intelligent inter-régions, avec bascule automatique en cas d'anomalie d'un nœud.

Comment comparer les performances et les coûts des différents modèles ?

Une seule API Key permet d'appeler tous les modèles ; changer de modèle ne nécessite que de modifier l'ID du modèle, sans aucune modification du code, ce qui évite d'intégrer chaque modèle séparément pour une comparaison transversale. Il est recommandé d'appeler chaque modèle avec le même lot d'échantillons métier, d'enregistrer la qualité des sorties et la consommation, puis de comparer point par point le prix officiel et le prix du site à l'aide du « tableau comparatif de tous les modèles » sur le site officiel.

Comment stocker en toute sécurité l'API Key côté serveur ?

Il est recommandé de conserver l'API Key uniquement côté serveur, en la transmettant via l'en-tête de requête sous forme de Bearer Token, sans l'inscrire dans le code front-end ou client. Les données de requête et de réponse de la plateforme sont chiffrées et transmises en HTTPS de bout en bout, et la plateforme offre une gestion des permissions de niveau entreprise ainsi que des journaux d'audit, rendant les enregistrements d'appels traçables.

Comment garantir la stabilité des appels et une faible latence en cas de forte concurrence ?

La plateforme s'appuie sur des centres de calcul situés à Horinger en Mongolie-Intérieure, Hami au Xinjiang, Zhongwei au Ningxia, etc., et utilise un algorithme d'ordonnancement développé en interne pour le routage intelligent inter-régions et l'équilibrage de charge dynamique, avec bascule automatique en cas d'anomalie d'un nœud ; les utilisateurs des grandes villes bénéficient d'une latence de l'ordre de la milliseconde, avec un engagement de disponibilité de service de 99.9%. Il est recommandé de compléter côté client par des relances avec backoff et une dégradation multi-modèles.

Comment surveiller le volume d'appels, les coûts et les anomalies ?

La plateforme propose un compte unifié et un système de facturation unique, avec une consommation transparente, un solde crédité en temps réel et un détail des consommations consultable à tout moment ; elle offre également une fonction de journal d'audit des appels API, rendant les enregistrements d'appels traçables. Les utilisateurs entreprise ayant des exigences de conformité plus strictes (gestion des permissions, journaux d'audit, etc.) peuvent contacter le service client pour un accompagnement commercial.