curl
Llame a los endpoints compatibles de HopBase con HTTP y curl.
| Tipo de modelo | Protocolo y endpoint | Autenticación |
|---|---|---|
| GPT / Gemini / GLM | POST https://api.hop-base.com/v1/chat/completions | Authorization: Bearer |
| Claude | POST https://api.hop-base.com/v1/messages | x-api-key |
| Imágenes | POST https://api.hop-base.com/v1/images/generations | Authorization: Bearer |
Autenticación y límites comunes
| Elemento | Regla | Si no se cumple |
|---|---|---|
| Cabecera de la clave | Authorization: Bearer sk-… o x-api-key: sk-…, aceptadas en todos los endpoints; no se admiten x-goog-api-key ni el parámetro de URL ?key= | 401 missing_api_key / invalid_api_key |
| Endpoint y grupo | Cada solicitud debe usar el endpoint del protocolo de su modelo (por ejemplo, los modelos Claude solo se pueden llamar por /v1/messages) | 404 "This API path is not supported by the current platform" |
| Modelo | Debe ser un modelo de uno de los grupos de la clave actual | 404 model_not_found |
| Tamaño del cuerpo | El cuerpo completo ≤ 60 MB | 413 |
GET /v1/models | Devuelve los ID de modelo disponibles para la clave actual; no se cobra | — |
Use un ID de modelo devuelto por GET /v1/models para la clave del plan actual. Una clave solo puede llamar a los modelos de los grupos que incluye.
Claude: indique max_tokens explícitamente.
En solicitudes Claude, omitir max_tokens no da error: se completa con 4096, así que una salida larga se corta en 4096 tokens (stop_reason: "max_tokens"). Indíquelo explícitamente.
Protocolo OpenAI (modelos GPT)
curl https://api.hop-base.com/v1/chat/completions \
-H "Authorization: Bearer sk-tu-clave" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "Hola"}]
}'Protocolo Anthropic (modelos Claude)
curl https://api.hop-base.com/v1/messages \
-H "x-api-key: sk-tu-clave" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hola"}]
}'Streaming (agregue "stream": true)
curl https://api.hop-base.com/v1/chat/completions \
-H "Authorization: Bearer sk-tu-clave" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-5.6-sol", "stream": true,
"messages": [{"role": "user", "content": "Hola"}]}'Próximos pasos
- Los límites de parámetros de cada protocolo están en las páginas SDK de OpenAI, SDK de Anthropic, Chat de Gemini y API de imágenes
- Si algo falla, revise Solución de problemas