Documentação da API

Guias de integração detalhados e referência da API para ajudá-lo a integrar rapidamente o serviço de API de IA da TokenWorks

1Início Rápido

Usar a API da TokenWorks é simples, basta seguir três etapas:

Registre uma conta na TokenWorks e faça login no console
Crie uma API Key no console
Use sua API Key para chamar nossas interfaces

Tip: Novos usuários receberão uma cota de teste gratuita após o registro, sem necessidade de vincular cartão de crédito para começar.

2URL Base

A URL base da API é a seguinte; todas as solicitações usam o protocolo HTTPS:

text

https://www.token8341.com/v1

Endpoint de conclusão de chat:

text

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

Note: Este endpoint é totalmente compatível com o formato da interface Chat Completions da OpenAI. Você pode usar diretamente o SDK da OpenAI para fazer chamadas.

3Método de Autenticação

A TokenWorks usa Bearer Token para autenticação na API. Inclua sua API Key no cabeçalho da solicitação:

text

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

Você pode criar e gerenciar suas chaves na página "API Keys" do console. Guarde sua API Key com segurança e não a exponha em repositórios públicos de código ou no código do cliente.

4Lista de Modelos Suportados

ID do Modelo	Nome do Modelo	Provedor
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

Mais modelos estão sendo integrados continuamente. Fique atento aos nossos avisos de atualização.

5Exemplos de Código

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

6Explicação dos Códigos de Erro

Quando uma solicitação à API falha, o código de status HTTP correspondente e a mensagem de erro são retornados no seguinte formato:

json

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

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