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 8341TokenFactory
1Início Rápido
Usar a API da 8341TokenFactory é simples, basta seguir três etapas:
- Registre uma conta na 8341TokenFactory 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/v1Endpoint de conclusão de chat:
text
POST https://www.token8341.com/v1/chat/completionsNote: 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 8341TokenFactory 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-hereVocê 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 | 状态 |
|---|---|---|---|
| deepseek-v4.1-flash | DeepSeek V4.1 Flash | DeepSeek | 可用 |
| deepseek-v4-pro | DeepSeek V4 Pro | DeepSeek | 可用 |
| deepseek-v4-flash | DeepSeek V4 Flash | DeepSeek | 可用 |
| kimi-k3 | Kimi K3 | Moonshot | 可用 |
| kimi-k2.5 | Kimi K2.5 | Moonshot | 可用 |
| glm-5.3 | GLM-5.3 | Zhipu | 可用 |
| glm-4.7-flash | GLM-4.7 Flash | Zhipu | 可用 |
| qwen3.8-max | Qwen3.8 Max | Alibaba Cloud | 可用 |
| qwen3.8-plus | Qwen3.8 Plus | Alibaba Cloud | 可用 |
| minimax-m3 | MiniMax M3 | MiniMax | 可用 |
| doubao-seed-2.1-pro | Doubao Seed 2.1 Pro | ByteDance | 可用 |
| ernie-5.1 | ERNIE 5.1 | Baidu | 可用 |
| - | GPT-4o / Claude / Gemini | OpenAI / Anthropic / Google | 暂未开放 |
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": "deepseek-v4.1-flash",
"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="deepseek-v4.1-flash",
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: "deepseek-v4.1-flash",
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 | 模型服务暂时不可用，请稍后重试 |
Perguntas frequentes sobre integração
Perguntas frequentes sobre API Key, troca de modelos e linguagens de integração
Uma única API Key pode chamar todos os modelos?
Sim. Essa é a característica central do 8341TokenFactory — o desenvolvedor precisa integrar apenas uma vez para chamar todos os modelos da plataforma, sem precisar solicitar contas separadas nem gerenciar Keys para cada fornecedor.
É preciso alterar o código para trocar de modelo?
Não é necessário alterar o código de lógica, basta mudar o parâmetro model ID para alternar entre modelos nacionais e internacionais.
Quais linguagens de programação são suportadas?
São fornecidos exemplos de integração para cURL, Python, Node.js e outras linguagens populares, compatíveis com qualquer linguagem que suporte requisições HTTP e com o SDK oficial da OpenAI.
Como é feita a autenticação da API?
O método de autenticação é Bearer Token; basta incluir a API Key no cabeçalho da requisição. A interface é totalmente compatível com o formato Chat Completions da OpenAI, podendo ser chamada diretamente com o SDK oficial da OpenAI, sem necessidade de adaptação adicional.
Existem SDKs ou exemplos de código prontos?
Sim. A plataforma oferece exemplos de integração em cURL, Python, Node.js e outras linguagens populares; os desenvolvedores podem escolher conforme sua linguagem para uma integração rápida.
Os modelos serão adicionados continuamente? Será preciso alterar o código para novos modelos?
Sim. A plataforma integra continuamente novos modelos nacionais e internacionais de destaque, mantendo o mesmo método de integração e o mesmo sistema de cobrança. Após o lançamento de novos modelos, não é necessário alterar o código para utilizá-los diretamente.
Como usar o mecanismo de cache da API de grandes modelos? Em quais cenários ele é acionado?
A plataforma utiliza cache compartilhado entre usuários para o mesmo prompt; quando acionado, o preço cai mais de 90%, com preço mínimo de cache de ¥0.010 / milhão de Tokens, e a parte acionada é cobrada pelo preço de cache. É adequado para cenários em que vários usuários reutilizam o mesmo prefixo de prompt, como prompts de sistema fixos, prefixos de conhecimento público etc. — coloque a parte invariável no início para obter maior taxa de acerto.
Se a chamada da API falhar ou expirar, como fazer retentativa automática e degradação?
A prática usual é: adotar retentativa com backoff exponencial para timeouts e erros retentáveis, definindo um número máximo de tentativas; se ainda falhar, degradar para um modelo de reserva. Na plataforma, trocar de modelo exige apenas alterar o ID do modelo, sem nenhuma mudança no código — basta escrever o destino de degradação como outro ID de modelo. Do lado da plataforma, há redundância multi-nó e roteamento inteligente entre regiões, com troca automática em caso de anomalia em um único nó.
Como comparar o desempenho e o custo de diferentes modelos?
Uma única API Key permite chamar todos os modelos; trocar de modelo exige apenas alterar o ID do modelo, sem nenhuma mudança no código, e não é necessário integrar cada modelo separadamente para fazer comparações horizontais. Recomenda-se usar o mesmo lote de amostras de negócio para chamar cada modelo, registrar a qualidade da saída e o consumo, e então comparar item a item o preço oficial e o preço deste site com base na "Tabela de comparação de preços de todos os modelos" do site oficial.
Como armazenar com segurança a API Key no lado do servidor?
Recomenda-se armazenar a API Key apenas no lado do servidor, enviando-a via cabeçalho de requisição no formato Bearer Token, e não incluí-la no código do front-end ou do cliente. Os dados de requisição e resposta da plataforma são transmitidos com criptografia HTTPS de ponta a ponta, e a plataforma oferece gerenciamento de permissões de nível empresarial e logs de auditoria, com registros de chamadas rastreáveis.
Em cenários de alta concorrência, como garantir estabilidade e baixa latência nas chamadas?
A plataforma conta com centros de computação em Horinger, na Mongólia Interior, Hami, em Xinjiang, Zhongwei, em Ningxia, entre outros locais, e realiza roteamento inteligente entre regiões e balanceamento de carga dinâmico por meio de algoritmos de agendamento próprios, com troca automática em caso de anomalia em um único nó; usuários em cidades principais podem obter latência de milissegundos, e a disponibilidade do serviço é garantida em 99.9%. Recomenda-se que o lado do cliente também combine retentativa com backoff e degradação para múltiplos modelos.
Como monitorar o volume de chamadas, os custos e as anomalias?
A plataforma oferece conta unificada e um único sistema de cobrança, com consumo transparente, saldo creditado em tempo real e detalhes de consumo consultáveis a qualquer momento; também oferece funcionalidade de logs de auditoria das chamadas da API, com registros rastreáveis. Usuários empresariais que precisem de requisitos de conformidade mais rigorosos (gerenciamento de permissões, logs de auditoria etc.) podem contatar o atendimento para tratar com o setor comercial.