Pular para o conteúdo principal

​
1. O que devo preencher como URL base da API?

Dependendo do protocolo, há principalmente as seguintes opções: Observação: se encontrar um erro 404, verifique se você adicionou /v1 a mais no final da URL. Ferramentas diferentes têm lógicas diferentes de concatenação de caminhos.

​
2. O que fazer se a chamada retornar 401 “token inválido”?

  1. Confirme se a API Key foi criada corretamente: https://jiekou.ai/settings/key-management
  2. Confirme se o formato de Authorization no cabeçalho da requisição é: Bearer sk_xxxxxx
  3. Se estiver usando Claude Code, a variável de ambiente deve ser definida como ANTHROPIC_AUTH_TOKEN=sk_xxxxx (não é necessário adicionar o prefixo Bearer; a ferramenta o adicionará automaticamente)

​
3. Como investigar quando a chamada retorna 404 “page not found”?

Causas comuns:
  • URL incorreta: por exemplo, uso de /v3/glm-asr com erro de digitação
  • Roteamento de modelo incorreto: por exemplo, modelos Codex precisam usar /v1/responses em vez de /v1/chat/completions
  • Problema de concatenação automática pela ferramenta: algumas ferramentas (como cc-switch) adicionam /chat/completions automaticamente; nesse caso, a Base URL não deve conter esse caminho

​
4. Como configurar Jiekou.AI no Claude Code?

Configure as variáveis de ambiente da seguinte forma: Windows cmd： 
set ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=sk_YOUR_API_KEY
set ANTHROPIC_MODEL=claude-opus-4-1-20250805
set ANTHROPIC_SMALL_FAST_MODEL=claude-sonnet-4-20250514
Mac/Linux bash： 
export ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic
export ANTHROPIC_AUTH_TOKEN=sk_YOUR_API_KEY
export ANTHROPIC_MODEL=claude-opus-4-1-20250805
export ANTHROPIC_SMALL_FAST_MODEL=claude-sonnet-4-20250514
Documentação de referência: https://docs.jiekou.ai/docs/integration/claudecode

​
5. Como resolver quando o Claude Code solicita login obrigatório/precisa de verificação?

A versão mais recente do Claude Code pode exigir login obrigatório. Soluções:
  • Usar o plugin Cline como alternativa (pesquise no marketplace de plugins do VSCode)
  • Ou usar em conjunto com ferramentas de encaminhamento como cc-switch

​
6. Como chamar os modelos GPT-5.1 / Codex? Por que retorna erro 400?

A série GPT-5.1 (incluindo Codex) precisa usar a Responses API da OpenAI, em vez de Chat Completions: 
curl "https://api.highwayapi.ai/openai/v1/responses" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <API Key>" \
-d '{
    "model": "gpt-5.1-codex",
    "input": [...],
    "max_output_tokens": 64000
  }'

​
7. O que fazer quando o Claude 4.5 retorna erros relacionados a “thinking block”?

A mensagem de erro geralmente é: Expected ‘thinking’ or ‘redacted_thinking’, but found ‘text’. Isso ocorre porque, após habilitar o recurso Thinking no Claude 4.5, o contexto deve conter um formato específico de bloco de pensamento. Recomendações:
  • Limpar o histórico da conversa e começar novamente
  • Ou desabilitar o recurso Thinking (se não for necessário)
  • Usar o protocolo nativo da Anthropic em vez do protocolo compatível com OpenAI (este último pode não oferecer suporte completo ao Thinking)

​
8. A chamada da Claude API retorna erro de “entrada muito longa”?

Os modelos Claude têm limite de tamanho de entrada (normalmente max_tokens suporta no máximo 64000). Verifique:
  • O comprimento do texto de entrada
  • O tamanho das imagens Base64 (para imagens muito grandes, recomenda-se compactá-las primeiro)
  • O comprimento acumulado do contexto do histórico de conversa
Entrar em contato com o suporte Se as FAQs acima não resolverem seu problema, entre em contato com o suporte técnico pelos seguintes meios:
  • Grupo de suporte técnico no WeCom/WeChat (recomendado, resposta mais rápida)
  • Formato das informações a fornecer:
    • Descrição do problema + captura de tela
    • ID da conta (UUID)
    • Trace ID (se houver, geralmente na mensagem de erro)
    • Parâmetros da requisição (após mascarar informações sensíveis)