Documentación de API

Guías de integración detalladas y referencia de API para ayudarle a integrar rápidamente los servicios de API de IA de TokenWorks

1Inicio rápido

Usar la API de TokenWorks solo requiere tres simples pasos:

Regístrese para obtener una cuenta de TokenWorks e inicie sesión en la consola
Cree una clave de API en la consola
Use su clave de API para llamar a nuestras interfaces

Tip: Los nuevos usuarios recibirán una cuota de prueba gratuita después del registro, sin necesidad de vincular una tarjeta de crédito para comenzar a usar.

2URL base

La URL base de la API es la siguiente; todas las solicitudes utilizan el protocolo HTTPS:

text

https://www.token8341.com/v1

Interfaz de finalización de chat:

text

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

Note: Esta interfaz es totalmente compatible con el formato de la interfaz Chat Completions de OpenAI; puede usar directamente el SDK de OpenAI para realizar llamadas.

3Método de autenticación

TokenWorks utiliza Bearer Token para la autenticación de API. Incluya su clave de API en el encabezado de la solicitud:

text

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

Puede crear y gestionar sus claves en la página «API Keys» de la consola. Guarde su clave de API de forma segura y no la exponga en repositorios de código públicos o en código de cliente.

4Lista de modelos compatibles

ID del modelo	Nombre del modelo	Proveedor
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

Se están integrando más modelos continuamente; preste atención a nuestros avisos de actualización.

5Código de ejemplo

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

6Explicación de códigos de error

Cuando una solicitud de API falla, se devuelve el código de estado HTTP correspondiente y el mensaje de error, con el siguiente formato:

json

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

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