SiCore TokenWorks

API-documentatie

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

1Snel starten

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

  1. Registreer een SiCore TokenWorks-account en log in op de console
  2. Maak een API Key aan in de console
  3. 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

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

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

Veelgestelde vragen over integratie

Veelgestelde vragen over API Key, modelwisseling en integratietalen

Kan één API Key alle modellen aanroepen?

Ja. Dit is het kernkenmerk van SiCore TokenWorks: ontwikkelaars hoeven slechts één keer te integreren om alle modellen op het platform aan te roepen, zonder voor elke leverancier afzonderlijk een account aan te vragen en Key te beheren.

Moet ik code aanpassen om van model te wisselen?

Je hoeft geen logische code aan te passen; alleen de parameter model ID wijzigen is voldoende om tussen binnenlandse en buitenlandse modellen te wisselen.

Welke programmeertalen worden ondersteund?

Er zijn integratievoorbeelden beschikbaar in cURL, Python, Node.js en andere gangbare talen, compatibel met elke taal die HTTP-verzoeken ondersteunt en met de officiële OpenAI SDK.

Hoe wordt de API geauthenticeerd?

De authenticatiemethode is Bearer Token; neem de API Key op in de request header. De interface is volledig compatibel met het Chat Completions-formaat van OpenAI en kan direct via de officiële OpenAI SDK worden aangeroepen, zonder extra aanpassingen.

Zijn er kant-en-klare SDK's of codevoorbeelden?

Ja. Het platform biedt voorbeelden voor cURL, Python, Node.js en andere gangbare integraties; ontwikkelaars kunnen eenvoudig de taal van hun keuze selecteren voor snelle integratie.

Worden er continu modellen toegevoegd? Moet code worden aangepast voor nieuwe modellen?

Ja. Het platform blijft nieuwe toonaangevende Chinese en internationale modellen integreren, met een consistent integratie- en facturatiemodel. Nieuwe modellen zijn na livegang direct te gebruiken zonder codewijzigingen.

Hoe gebruik je het cachemecanisme van de grote-model-API? In welke scenario's wordt er een cachehit behaald?

Het platform gebruikt een gedeelde cache voor identieke prompts across gebruikers. Bij een cachehit daalt de prijs met meer dan 90%; de laagste cachehit-prijs is ¥0.010 per miljoen Token, en het gedeelte met een cachehit wordt tegen de cacheprijs gefactureerd. Dit is geschikt voor scenario's waarin meerdere gebruikers dezelfde prefix-prompt herhaaldelijk gebruiken, zoals een vaste systeemprompt of een algemene kennisprefix. Zet het onveranderlijke deel vooraan voor een hogere hitratio.

Hoe implementeer je automatische retries en fallback wanneer een API-aanroep mislukt of een timeout optreedt?

De gebruikelijke aanpak is: gebruik exponentiële backoff voor timeouts en herhaalbare fouten, en stel een maximum aantal retries in; val bij blijvende fouten terug op een reservemodel. Op het platform volstaat het wijzigen van het model-ID om van model te wisselen, zonder codewijzigingen; stel het fallback-doel in als een ander model-ID. Platformzijde zijn er ook multi-node redundantie en intelligente cross-regio-routering, waarbij een storing op één node automatisch wordt omgeschakeld.

Hoe vergelijk je de prestaties en kosten van verschillende modellen?

Met één API Key kun je alle modellen aanroepen; voor het wisselen van model wijzig je alleen het model-ID, zonder codewijzigingen, zodat je voor een horizontale vergelijking niet elk model apart hoeft te integreren. Het is aan te raden dezelfde set bedrijfsvoorbeelden per model aan te roepen, de uitvoerkwaliteit en het verbruik te registreren, en vervolgens met de 'volledige modelprijsvergelijkingstabel' op de officiële website de officiële prijzen en de prijzen van deze site punt voor punt te vergelijken.

Hoe bewaar je de API Key aan de serverzijde veilig?

Het is aan te raden de API Key alleen aan de serverzijde op te slaan en via de request-header als Bearer Token mee te sturen; zet deze niet in frontend- of clientcode. De request- en responsdata van het platform worden volledig via HTTPS versleuteld verzonden, en het platform biedt enterprise-grade rechtenbeheer en auditlogs, zodat aanroepen traceerbaar zijn.

Hoe waarborg je stabiele aanroepen en lage latency in scenario's met hoge gelijktijdigheid?

Het platform leunt op rekencentra in onder andere Horinger in Binnen-Mongolië, Hami in Xinjiang en Zhongwei in Ningxia, en gebruikt zelfontwikkelde scheduling-algoritmen voor intelligente cross-regio-routering en dynamische load balancing, met automatische omschakeling bij een storing op één node; gebruikers in kernsteden krijgen latency op millisecondeniveau, met een service-beschikbaarheid van 99.9%. Het is aan te raden om aan de clientzijde ook backoff-retries en multi-model-fallback te combineren.

Hoe monitor je het aanroepvolume, de kosten en afwijkingen?

Het platform biedt een uniform account en één factureringssysteem, met transparant verbruik, een realtime bijgewerkt saldo en de mogelijkheid om op elk moment de verbruiksdetails te bekijken; daarnaast is er auditlogging voor API-aanroepen, zodat aanroepen traceerbaar zijn. Enterprise-gebruikers die strengere compliance-eisen hebben (rechtenbeheer, auditlogs, enz.) kunnen contact opnemen met de klantenservice voor een zakelijke koppeling.