API-Dokumentation

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

1Schnellstart

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

Registrieren Sie ein TokenWorks-Konto und melden Sie sich in der Konsole an
Erstellen Sie einen API-Key in der Konsole
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

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-ID	Modellname	Anbieter
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

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
  }
}

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