HopBase DocsBase URLs y protocolos
Elija la URL compatible con OpenAI o Anthropic de HopBase para cada modelo y cliente.
| Escenario | Protocolo | Base URL |
|---|---|---|
| Modelos Claude (Claude Code, SDK de Anthropic) | Solo Anthropic Messages — /v1/chat/completions y /v1/responses no se admiten | https://api.hop-base.com |
| Codex CLI | OpenAI Responses | https://api.hop-base.com/v1 |
| Chat de GPT | OpenAI Chat Completions o Responses; también Anthropic Messages, así que Claude Code se conecta directamente | https://api.hop-base.com/v1; Anthropic: https://api.hop-base.com |
| Chat de Gemini, grupo Gemini (todos los modelos, incl. imagen) | OpenAI Chat Completions o Responses; también Anthropic Messages, así que Claude Code se conecta directamente. Codex CLI no es compatible | https://api.hop-base.com/v1; Anthropic: https://api.hop-base.com |
| Chat de Gemini, grupo Gemini oficial directo | Solo OpenAI Chat Completions — /v1/responses y /v1/messages no se admiten; en formato OpenAI se ignoran los tools (detalles) | https://api.hop-base.com/v1 |
| Chat de Grok | OpenAI Chat Completions o Responses; también Anthropic Messages, así que Claude Code se conecta directamente. Codex CLI no es compatible | https://api.hop-base.com/v1; Anthropic: https://api.hop-base.com |
| Chat de Qwen | OpenAI Chat Completions o Responses; también Anthropic Messages, así que Claude Code se conecta directamente | https://api.hop-base.com/v1; Anthropic: https://api.hop-base.com |
| DeepSeek V4 / V4.1 | OpenAI Chat Completions o Responses; también Anthropic Messages, así que Claude Code se conecta directamente | https://api.hop-base.com/v1; Anthropic: https://api.hop-base.com |
DeepSeek y GLM de la región de EE. UU. (-us) | OpenAI Chat Completions, Responses y Anthropic Messages, así que Claude Code se conecta directamente — vea Región de EE. UU. | https://api.hop-base.com/v1; Anthropic: https://api.hop-base.com |
| GLM-5.3 / GLM-5.3 Flash, grupo GLM oficial directo | Solo OpenAI Chat Completions — /v1/responses y /v1/messages no se admiten y devuelven 400. Codex CLI no puede conectarse; Claude Code necesita el enrutamiento local de CC Switch | https://api.hop-base.com/v1 |
| Kimi K3 | Solo OpenAI Chat Completions — /v1/responses y /v1/messages no se admiten y devuelven 404. Codex CLI no puede conectarse; Claude Code necesita el enrutamiento local de CC Switch | https://api.hop-base.com/v1 |
| GPT Image, Gemini Banana, Seedream | OpenAI Images | https://api.hop-base.com/v1 |
Un protocolo que no figura para un modelo no está admitido. Gemini tampoco tiene la ruta nativa :generateContent, y esta API no acepta x-goog-api-key.
HopBase admite protocolos compatibles tanto con OpenAI como con Anthropic; cuál usar depende del cliente y el tipo de modelo, no del formato de la clave.
Endpoints comunes
¿Viene de OpenAI, OpenRouter o Anthropic? Consulte Cambiar a HopBase. Los campos de respuesta de /v1/models, /v1/usage y el catálogo público están en API de cuenta y catálogo.
| Capacidad | Endpoint |
|---|---|
| Descubrimiento de modelos | GET /v1/models |
| Saldo y consumo de la clave actual | GET /v1/usage |
| Catálogo público de modelos y precios de lista (sin clave) | GET /api/v1/models/pricing |
| OpenAI chat | POST /v1/chat/completions |
| OpenAI Responses | POST /v1/responses |
| Anthropic Messages | POST /v1/messages |
| Gemini Omni (multimodal / video) | POST /v1beta/interactions |
| Generación de imágenes | POST /v1/images/generations |
| Edición de imágenes | POST /v1/images/edits |
| Texto a voz | POST /v1/audio/speech / POST /v1/t2a_v2 |
| Consulta de tareas asíncronas de imagen | GET /v1/images/tasks?task_id= |
| Carga de assets (referencias para tareas asíncronas) | POST /v1/sd/assets |
| Envío de generación de video | POST /v1/video/generate |
| Sondeo de tareas de video | GET /v1/video/tasks/{task_id} |
| Detección facial Kling | POST /v1/kling/faces |
| Sujetos Kling | POST /v1/kling/subjects / GET /v1/kling/subjects |
| Envío de video Wan / HappyHorse | POST /api/v1/services/aigc/video-generation/video-synthesis |
| Sondeo de tareas Wan / HappyHorse | GET /api/v1/tasks/{task_id} |
POST /v1/video/generate y GET /v1/video/tasks/{task_id} son compartidos por todas las familias de video asíncronas — Seedance, MiniMax, Kling y el video de Grok envían y sondean por estas mismas dos rutas; solo cambian el cuerpo de la solicitud y el ID del modelo. Kling solo necesita la Base URL y la clave API de HopBase.
Wan 3.0 y HappyHorse no usan la ruta /v1/video/generate de arriba. Mantienen la ruta nativa de la API oficial directamente bajo el host: https://api.hop-base.com/api/v1/services/aigc/video-generation/video-synthesis — no hay un /v1 adicional delante de ese segmento /api/v1/....
Configurar una clave Claude como OpenAI Compatible envía las solicitudes a la ruta de protocolo incorrecta y devuelve 404, "The current platform does not support this API path". Cambie el tipo de proveedor a Anthropic y elimine /v1 de la Base URL.
Próximos pasos
- OpenAI SDK: Base URL, claves y ejemplos de chat del protocolo OpenAI
- Anthropic SDK: el protocolo Anthropic Messages, sin /v1
- Modelos disponibles: consulte los ID de modelo disponibles para una clave