01 · INICIO RÁPIDO
Tu primera request
Creá una API key desde el panel, elegí el grupo que corresponde a tu caso y usá la Base URL https://orbiqen.com/v1. No agregues /v1 una segunda vez.
- Recargá saldo. El servicio funciona con crédito prepago en USD.
- Creá una key. Elegí su grupo y los modelos permitidos antes de compartirla con una aplicación.
- Probá la conexión. Enviá una request corta y revisá su detalle en Usage.
curl https://orbiqen.com/v1/chat/completions \
-H "Authorization: Bearer TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.5","messages":[{"role":"user","content":"Hola"}]}'02 · CONTROL DE ACCESO
Keys y grupos de enrutamiento
Una key hija no hereda el catálogo completo de una key administrativa. Solo puede usar los modelos habilitados dentro del grupo elegido al crearla.
| Grupo | Qué habilita | Qué no habilita |
|---|---|---|
| ChatGPT económico | Modelos GPT seleccionados para tareas habituales. | Claude e imágenes del grupo estable. |
| ChatGPT estable | Modelos GPT seleccionados y los modelos de imagen publicados. | Claude, salvo que se cree una key Claude. |
| Claude | Solo los modelos Claude que marques en esa key. | Modelos GPT, imagen y modelos chinos. |
| Modelos chinos | Modelos publicados de esa familia, por modelo. | GPT y Claude, salvo otra key independiente. |
03 · FACTURACIÓN TRANSPARENTE
Cómo se calcula un consumo
Las tarifas publicadas son precios finales en USD por un millón de tokens. Una solicitud puede incluir entrada, salida y, si el modelo lo informa, lectura o escritura de caché.
(input × tarifa input) + (output × tarifa output) + (caché × tarifa caché)Qué vas a ver
- Input: tokens enviados al modelo.
- Output: tokens generados por el modelo.
- Cache read/write: contexto reutilizado cuando aplica.
Qué no se suma
- No hay suscripción obligatoria.
- No hay cargo fijo por request.
- No hay recargo oculto al descontar saldo.
Los precios pueden diferir de proveedores oficiales u otros agregadores porque dependen de capacidad, rutas y condiciones comerciales. Orbiqen no promete ser siempre el más barato: publica la tarifa vigente y deja cada request auditable.
04 · DISPONIBILIDAD
Rutas internas y fallback
Ruta principal
Es la conexión preferida para un grupo y modelo. El cliente usa siempre el mismo endpoint público de Orbiqen.
Fallback
Puede usarse cuando una ruta upstream no está disponible. No expone proveedores internos y no significa una garantía de latencia fija.
05 · AUDITORÍA
Verificá cada consumo en Usage
Después de enviar una request, abrí Usage en el panel. El historial permite revisar y explicar un descuento sin depender de estimaciones.
06 · SOLUCIÓN DE PROBLEMAS
Errores comunes
| Mensaje | Qué revisar |
|---|---|
401 o token inválido | La key está incompleta, revocada o fue enviada en un header incorrecto. |
403 sin acceso al modelo | El modelo no está habilitado para esa key o pertenece a otro grupo. |
400 Invalid URL | Configurá https://orbiqen.com/v1 como Base URL, sin duplicar /v1. |
| Saldo insuficiente | Recargá crédito o reducí el límite de salida de tu request. |
07 · COMPATIBILIDAD ANTHROPIC
Usar Claude con la API nativa
Las keys del grupo Claude también pueden utilizar el formato nativo de Anthropic. Mantené el modelo dentro de los permitidos por tu key.
curl https://orbiqen.com/v1/messages \
-H "x-api-key: TU_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":256,"messages":[{"role":"user","content":"Hola"}]}'08 · PREGUNTAS FRECUENTES
Antes de pasar a producción
¿Puedo usar la misma key para todo?
Podés, pero no es recomendable. Separar keys por proyecto permite revocar accesos, asignar límites y entender quién consume cada saldo.
¿Las imágenes usan otro endpoint?
Los modelos de imagen publicados se usan desde la ruta compatible de Orbiqen. Habilitalos únicamente en las keys del grupo estable que los necesiten.
¿El fallback se activa si una request tarda mucho?
El fallback responde a indisponibilidad o error de la ruta. No debe considerarse un mecanismo de timeout para requests que todavía siguen en curso.
¿Cómo pruebo con US$ 1?
Hacé requests cortas, elegí un modelo acorde a la tarea y revisá Usage después de cada prueba. El costo real depende de los tokens generados y del contexto enviado.