> ## 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.

# Configuración de API e integración técnica

## 1. ¿Qué debo poner como URL base de la API?

Según el protocolo, existen principalmente las siguientes opciones:

* Formato compatible con OpenAI: [https://api.highwayapi.ai/openai](https://api.highwayapi.ai/openai) o [https://api.highwayapi.ai/openai/v1/chat/completions](https://api.highwayapi.ai/openai/v1/chat/completions)
* Protocolo nativo de Anthropic: [https://api.highwayapi.ai/anthropic](https://api.highwayapi.ai/anthropic) (para herramientas como Claude Code)
* Uso exclusivo para generación de imágenes/videos: [https://api.highwayapi.ai/v3/](https://api.highwayapi.ai/v3/) (como Gemini, Nano Banana, etc.)

Nota: si se produce un error 404, compruebe si ha añadido un /v1 de más al final de la URL; distintas herramientas tienen lógicas diferentes para concatenar rutas.

## 2. ¿Qué hacer si al llamar devuelve 401 "token no válido"?

1. Confirme que la clave de API se haya creado correctamente: [https://jiekou.ai/settings/key-management](https://jiekou.ai/settings/key-management)
2. Confirme que el formato de Authorization en el encabezado de la solicitud sea: Bearer sk\_xxxxxx
3. Si usa Claude Code, la variable de entorno debe configurarse como ANTHROPIC\_AUTH\_TOKEN=sk\_xxxxx (no es necesario añadir el prefijo Bearer; la herramienta lo añadirá automáticamente)

## 3. ¿Cómo diagnosticar un 404 "page not found" al llamar?

Causas comunes:

* URL incorrecta: por ejemplo, usar /v3/glm-asr pero escribirla mal
* Enrutamiento de modelo incorrecto: por ejemplo, los modelos Codex deben usar /v1/responses en lugar de /v1/chat/completions
* Problema de concatenación automática de la herramienta: algunas herramientas (como cc-switch) añaden automáticamente /chat/completions; en ese caso, la Base URL no debe incluir esa ruta

## 4. ¿Cómo configurar Jiekou.AI en Claude Code?

Configure las variables de entorno de la siguiente manera:

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
```

Documentación de referencia: [https://docs.jiekou.ai/docs/integration/claudecode](https://docs.jiekou.ai/docs/integration/claudecode)

## 5. ¿Cómo resolver el aviso de inicio de sesión obligatorio/verificación requerida en Claude Code?

La versión más reciente de Claude Code puede exigir iniciar sesión obligatoriamente. Soluciones:

* Use el complemento Cline como alternativa (búsquelo en el marketplace de extensiones de VSCode)
* O úselo junto con herramientas de reenvío como cc-switch

## 6. ¿Cómo llamar a modelos GPT-5.1 / Codex? ¿Por qué devuelve un error 400?

La serie GPT-5.1 (incluido Codex) debe usar la Responses API de OpenAI, no 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. ¿Qué hacer si Claude 4.5 devuelve un error relacionado con "thinking block"?

El error suele indicar: Expected 'thinking' or 'redacted\_thinking', but found 'text'. Esto se debe a que, después de habilitar la función Thinking en Claude 4.5, el contexto debe contener un formato específico de bloque de razonamiento. Se recomienda:

* Borrar el historial de conversación y comenzar de nuevo
* O deshabilitar la función Thinking (si no la necesita)
* Usar el protocolo nativo de Anthropic en lugar del protocolo compatible con OpenAI (este último puede tener soporte incompleto para Thinking)

## 8. ¿La llamada a Claude API devuelve un error de "entrada demasiado larga"?

Los modelos Claude tienen límites de longitud de entrada (por lo general, max\_tokens admite como máximo 64000). Compruebe:

* La longitud del texto de entrada
* El tamaño de las imágenes Base64 (se recomienda comprimir primero las imágenes demasiado grandes)
* La longitud acumulada del contexto del historial de conversación

***

**Contactar con soporte**

Si las FAQ anteriores no resuelven su problema, contacte con el soporte técnico mediante los siguientes canales:

* Grupo de soporte técnico en WeCom/WeChat (recomendado, respuesta más rápida)
* Formato de información que debe proporcionar:
  * Descripción del problema + capturas de pantalla
  * ID de cuenta (UUID)
  * Trace ID (si lo tiene, normalmente aparece en el mensaje de error)
  * Parámetros de solicitud (después de anonimizar la información sensible)