Saltar al contenido principal

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

Según el protocolo, existen principalmente las siguientes opciones: 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
  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

​
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)