SiCore TokenWorks

API-Dokumentation

Detaillierte Integrationsanleitungen und API-Referenz für die schnelle Integration der SiCore TokenWorks AI-API-Dienste

1Schnellstart

Die Verwendung der SiCore TokenWorks-API erfordert nur drei einfache Schritte:

  1. Registrieren Sie ein SiCore TokenWorks-Konto und melden Sie sich in der Konsole an
  2. Erstellen Sie einen API-Key in der Konsole
  3. Rufen Sie unsere Schnittstellen mit Ihrem API-Key auf

Tip: Neue Benutzer erhalten nach der Registrierung ein kostenloses Testguthaben, ohne eine Kreditkarte hinterlegen zu müssen.

2Basis-URL

Die Basisadresse der API lautet wie folgt, alle Anfragen verwenden das HTTPS-Protokoll:

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

Chat-Completion-Schnittstelle:

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

Note: Diese Schnittstelle ist vollständig kompatibel mit dem Chat-Completions-Format von OpenAI. Sie können direkt das OpenAI-SDK für Aufrufe verwenden.

3Authentifizierungsmethode

SiCore TokenWorks verwendet Bearer-Token für die API-Authentifizierung. Bitte fügen Sie Ihren API-Key in den Anfrage-Header ein:

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

Sie können Ihre Schlüssel auf der Seite „API Keys“ in der Konsole erstellen und verwalten. Bewahren Sie Ihren API-Key sicher auf und geben Sie ihn nicht in öffentlichen Code-Repositories oder Client-Code preis.

4Liste der unterstützten Modelle

Modell-IDModellnameAnbieter
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

Weitere Modelle werden kontinuierlich integriert. Bitte beachten Sie unsere Update-Ankündigungen.

5Beispielcode

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

6Fehlercode-Erläuterung

Bei fehlgeschlagenen API-Anfragen werden der entsprechende HTTP-Statuscode und die Fehlermeldung zurückgegeben, im folgenden Format:

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

Häufige Fragen zur Integration

Häufige Fragen zu API Key, Modellwechsel und Integrationssprachen

Kann ein API Key alle Modelle aufrufen?

Ja. Das ist das Kernmerkmal von SiCore TokenWorks – Entwickler integrieren sich nur einmal und können alle Modelle der Plattform aufrufen, ohne für jeden Anbieter separat ein Konto anzulegen und Keys zu verwalten.

Muss der Code für einen Modellwechsel geändert werden?

Der Logikcode muss nicht geändert werden, nur der eine Parameter model ID, um zwischen inländischen und ausländischen Modellen zu wechseln.

Welche Programmiersprachen werden unterstützt?

Es werden Integrationsbeispiele für cURL, Python, Node.js und andere gängige Sprachen bereitgestellt, kompatibel mit jeder Sprache, die HTTP-Anfragen unterstützt, sowie mit dem offiziellen OpenAI SDK.

Wie erfolgt die Authentifizierung der API?

Die Authentifizierung erfolgt über einen Bearer Token; es genügt, den API Key im Request-Header mitzuführen. Die Schnittstelle ist vollständig kompatibel mit dem Chat Completions-Format von OpenAI und kann direkt über das offizielle OpenAI SDK aufgerufen werden, ohne zusätzliche Anpassung.

Gibt es fertige SDKs oder Codebeispiele?

Ja. Die Plattform bietet Integrationsbeispiele für cURL, Python, Node.js und weitere gängige Sprachen; Entwickler wählen einfach ihre Sprache und können schnell integrieren.

Werden laufend neue Modelle hinzugefügt? Muss der Code für neue Modelle geändert werden?

Ja. Die Plattform bindet kontinuierlich neue führende chinesische und internationale Modelle ein; die Integrationsweise und das Abrechnungssystem bleiben konsistent. Nach der Veröffentlichung neuer Modelle können diese ohne Codeänderung direkt ausgewählt werden.

Wie nutzt man den Cache-Mechanismus der Large-Model-API? In welchen Szenarien wird ein Cache-Treffer erzielt?

Die Plattform verwendet einen Cache, der bei identischem prompt nutzerübergreifend geteilt wird. Bei einem Treffer sinkt der Preis um weitere über 90 %, der Cache-Trefferpreis liegt bei mindestens ¥0.010 pro Million Token, und der getroffene Teil wird zum Cache-Preis abgerechnet. Geeignet ist dies für Szenarien, in denen mehrere Nutzer denselben Präfix-prompt wiederholt verwenden, beispielsweise feste System-Prompts, gemeinsame Wissenspräfixe und Ähnliches – stellt den unveränderlichen Teil nach vorne, dann ist die Trefferrate höher.

Wie richtet man automatische Wiederholungsversuche und ein Fallback ein, wenn ein API-Aufruf fehlschlägt oder ein Timeout auftritt?

Üblicherweise geht man so vor: Bei Timeouts und wiederholbaren Fehlern werden Wiederholungsversuche mit exponentiellem Backoff durchgeführt und eine maximale Anzahl an Wiederholungen festgelegt; schlägt dies weiterhin fehl, erfolgt ein Fallback auf ein Ausweichmodell. Auf der Plattform muss zum Modellwechsel nur die Modell-ID geändert werden, der Code bleibt unverändert – man schreibt einfach eine andere Modell-ID als Fallback-Ziel. Plattformseitig gibt es zudem Mehrknoten-Redundanz und intelligentes Cross-Region-Routing, bei einer Anomalie eines einzelnen Knotens wird automatisch umgeschaltet.

Wie vergleicht man die Ergebnisse und Kosten verschiedener Modelle?

Mit einem einzigen API Key können alle Modelle aufgerufen werden; beim Modellwechsel ändert sich nur die Modell-ID, der Code bleibt unverändert, sodass für einen Quervergleich keine separate Anbindung pro Modell nötig ist. Empfohlen ist, dieselbe Stichprobe von Geschäftsdaten jeweils aufzurufen, die Ausgabequalität und den Verbrauch zu erfassen und dann anhand der „Vergleichstabelle aller Modelle“ auf der offiziellen Website Punkt für Punkt den offiziellen Preis mit dem Preis dieser Seite zu vergleichen.

Wie speichert man den API Key serverseitig sicher?

Empfohlen ist, den API Key ausschließlich serverseitig zu speichern und ihn über den Request-Header als Bearer Token mitzuführen; schreibt ihn nicht in den Frontend- oder Client-Code. Die Anfrage- und Antwortdaten der Plattform werden durchgängig per HTTPS verschlüsselt übertragen, zudem werden unternehmensweite Berechtigungsverwaltung und Audit-Logs bereitgestellt, sodass Aufrufaufzeichnungen nachvollziehbar sind.

Wie gewährleistet man in Szenarien mit hoher Parallelität stabile Aufrufe und niedrige Latenz?

Die Plattform stützt sich auf Rechenzentren in Orten wie Horinger in der Inneren Mongolei, Hami in Xinjiang und Zhongwei in Ningxia und führt über selbst entwickelte Scheduling-Algorithmen intelligentes Cross-Region-Routing und dynamischen Lastausgleich durch; bei einer Anomalie eines einzelnen Knotens wird automatisch umgeschaltet. Nutzer in Kernstädten erhalten Latenzen im Millisekundenbereich, die zugesicherte Serviceverfügbarkeit beträgt 99.9%. Empfohlen ist, clientseitig zusätzlich Backoff-Wiederholungsversuche und Multi-Modell-Fallback einzusetzen.

Wie überwacht man Aufrufvolumen, Kosten und Anomalien?

Die Plattform bietet ein einheitliches Konto und ein einheitliches Abrechnungssystem, der Verbrauch ist transparent, das Guthaben wird in Echtzeit gutgeschrieben und die Verbrauchsdetails sind jederzeit einsehbar; zugleich wird eine Audit-Log-Funktion für API-Aufrufe bereitgestellt, sodass Aufrufaufzeichnungen nachvollziehbar sind. Unternehmensnutzer, die strengere Compliance-Anforderungen haben (Berechtigungsverwaltung, Audit-Logs usw.), können sich für die geschäftliche Anbindung an den Kundenservice wenden.