> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuração da API e integração técnica

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

Dependendo do protocolo, há principalmente as seguintes opções:

* Formato compatível com OpenAI: [https://api.highwayapi.ai/openai](https://api.highwayapi.ai/openai) ou [https://api.highwayapi.ai/openai/v1/chat/completions](https://api.highwayapi.ai/openai/v1/chat/completions)
* Protocolo nativo da Anthropic: [https://api.highwayapi.ai/anthropic](https://api.highwayapi.ai/anthropic) (usado para ferramentas como Claude Code)
* Exclusivo para geração de imagens/vídeos: [https://api.highwayapi.ai/v3/](https://api.highwayapi.ai/v3/) (como Gemini, Nano Banana etc.)

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](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](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)