Preguntas frecuentes
Preguntas comunes sobre la integración con HopBase, claves, protocolos, modelos y clientes.
No. HopBase es accesible directamente desde China continental sin proxy.
Los protocolos OpenAI para GPT, Codex y clientes de terceros incluyen /v1. El protocolo Anthropic para Claude Code y el SDK de Anthropic no lo incluye; esos clientes añaden la ruta de la API por sí mismos.
Seleccione OpenAI Chat Completions (routing required), use https://api.hop-base.com/v1 y configure el modelo como glm-5.3.
Use el protocolo OpenAI Images: POST https://api.hop-base.com/v1/images/generations con model, prompt y size. Gemini Banana y Seedream 5.0 Pro usan el mismo protocolo del lado del cliente, pero las capacidades de imagen a imagen y asíncronas varían. Seedream admite generación síncrona y edición con hasta 10 imágenes de referencia. Añada image al JSON de generations o use /v1/images/edits. Consulte la API de imágenes.
Sí. Una clave puede incluir hasta 10 grupos de distintas plataformas: al crear una clave en Claves API de la consola, añada un grupo Codex Plus o Codex Pro para GPT y un grupo Claude Max para Claude, o edite una clave existente para añadir el grupo que falte. Cada solicitud se factura según el grupo que sirve su modelo. Llame a cada modelo por su propio protocolo: GPT por los endpoints compatibles con OpenAI y Claude por /v1/messages.
Sí. El diálogo de configuración con un clic de la consola proporciona un comando de Windows PowerShell. Para la configuración manual, consulte la pestaña Windows PowerShell de las páginas Claude Code y Codex CLI.
El comando contiene un token de integración de un solo uso que expira después de 15 minutos, no la clave API en sí. El script solo actualiza la configuración local y respalda la configuración existente.
Sí. El consumo de la misma clave se combina en una sola cuenta. Usar claves con nombre independientes por dispositivo facilita atribuir el consumo.
Inicie sesión en la consola. Consumo muestra el modelo, el número de tokens y el cargo de cada solicitud. Desde código, llame a GET https://api.hop-base.com/v1/usage con una clave API para obtener el saldo disponible para esa clave (ya limitado por las cuotas de la clave y de su empresa); los campos de la respuesta están en API de cuenta y catálogo.
Inicie sesión en la consola, seleccione Recarga en el menú, elija un importe y siga las indicaciones de pago. Antes de pagar, la página muestra el importe a pagar y el importe que se acreditará; el saldo se acredita automáticamente cuando el pago se completa. Para otros métodos de pago, como una transferencia bancaria de empresa, contáctenos.
Desde el 2026-10-01 su saldo está en dólares estadounidenses (USD): la consola muestra el saldo, los cargos y los registros de consumo en $, y los modelos se facturan al precio oficial en dólares estadounidenses multiplicado por la tasa de su grupo. Los saldos anteriores al cambio se convirtieron a USD con una tasa fija, así que lo que puede gastar no cambió. El cost que devuelve la API es el mismo cargo en CNY; el importe en USD está en cost_usd. Vea Moneda del saldo. En las recargas, la moneda de pago, las comisiones y el importe acreditado son los que muestra la página Recarga antes de pagar; en las transferencias bancarias de empresa y las recargas fuera de línea en CNY, el importe en USD que se acredita lo confirma el equipo de soporte.
Según la sección 4 de los Términos del servicio, el saldo consumido y el saldo de bonificación, como promociones o recompensas, no se reembolsan en efectivo. Para cualquier otra solicitud de reembolso, contáctenos con el correo de su cuenta y el número de pedido de Historial de recargas.
Para facturas o facturación de empresa, contáctenos con el correo de su cuenta, el número de pedido de Historial de recargas y sus datos de facturación.
Normalmente indica que el modelo está temporalmente no disponible o que la respuesta superó el tiempo de espera. Reintente con retroceso exponencial, o cambie a otro modelo de la misma familia. Si persiste más de 10 minutos, contáctenos con el X-Request-ID de los encabezados de respuesta. Las reglas de reintento están en Códigos de error y reintentos.
Lea error.message (sin code, sin facturar) y corrija eso antes de reenviar. Consulte Códigos de error y reintentos.
Se admiten conexiones directas desde el navegador. Los clientes web a menudo no añaden una ruta de API. Para los modos OpenAI, GPT o GLM, ingrese la URL completa https://api.hop-base.com/v1. Para el modo Anthropic y Claude, omita /v1.
Próximos pasos
- Solución de problemas: busque un mensaje de error
- Concurrencia, tiempos de espera y facturación: límites de concurrencia y cómo se factura
- API de cuenta y catálogo: consulte el saldo disponible con una clave API