Documentazione API

Guide di integrazione dettagliate e riferimento API per integrare rapidamente i servizi API AI di TokenWorks

1Avvio rapido

Utilizzare l'API TokenWorks richiede solo tre semplici passaggi:

Registrare un account TokenWorks e accedere alla console
Creare una chiave API nella console
Utilizzare la propria chiave API per chiamare le nostre interfacce

Tip: I nuovi utenti riceveranno una quota di prova gratuita dopo la registrazione, senza bisogno di associare una carta di credito per iniziare.

2Indirizzo dell'interfaccia

L'indirizzo di base dell'API è il seguente; tutte le richieste utilizzano il protocollo HTTPS:

text

https://www.token8341.com/v1

Interfaccia di completamento chat:

text

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

Note: Questa interfaccia è completamente compatibile con il formato dell'interfaccia Chat Completions di OpenAI; è possibile utilizzare direttamente l'SDK di OpenAI per effettuare chiamate.

3Metodo di autenticazione

TokenWorks utilizza Bearer Token per l'autenticazione API. Includere la propria chiave API nell'intestazione della richiesta:

text

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

È possibile creare e gestire le proprie chiavi nella pagina «API Keys» della console. Conservare con cura la propria chiave API e non esporla in repository di codice pubblici o nel codice client.

4Elenco dei modelli supportati

ID modello	Nome modello	Fornitore
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

Ulteriori modelli sono in fase di integrazione continua; si prega di seguire i nostri aggiornamenti.

5Codice di esempio

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

6Spiegazione dei codici di errore

Quando una richiesta API fallisce, vengono restituiti il codice di stato HTTP e il messaggio di errore corrispondenti, nel formato seguente:

json

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

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