SiCore TokenWorks

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 SiCore TokenWorks

1Início Rápido

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

  1. Registre uma conta na SiCore TokenWorks e faça login no console
  2. Crie uma API Key no console
  3. 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 SiCore 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 ModeloNome do ModeloProvedor
gpt-4oGPT-4oOpenAI
gpt-4o-miniGPT-4o MiniOpenAI
claude-3-5-sonnetClaude 3.5 SonnetAnthropic
claude-4-sonnetClaude 4 SonnetAnthropic
gemini-2-0-proGemini 2.0 ProGoogle
deepseek-v4-proDeepSeek-V4-ProDeepSeek
qwen-maxQwen-MaxAlibaba 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 StatusNomeDescrição
400Bad Request请求参数错误，请检查请求体格式
401UnauthorizedAPI Key 无效或缺失，请检查 Authorization 请求头
402Insufficient Balance账户余额不足，请充值后重试
404Not Found请求的模型或接口不存在
429Rate Limit请求频率过高，请稍后重试
500Internal Server Error服务内部错误，请联系技术支持
503Service 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 SiCore TokenWorks — 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.