La API de Genlaxy
Todos los modelos del catálogo, desde tu propio código. Una clave, un saldo, los mismos precios que en el estudio.
1 · Autenticación
Crea una clave en Ajustes, Claves de API. Envíala en cada solicitud como token Bearer. Las claves empiezan por gl_live_ y solo funcionan en Genlaxy; guárdalas en tu servidor, nunca en un navegador ni en una app.
curl https://genlaxy.ai/api/v1/api/catalog/me \
-H 'Authorization: Bearer gl_live_...'2 · Elige un modelo
Elige un modelo para ver una solicitud lista creada con sus propios campos. Los campos obligatorios ya están rellenados y cada ajuste opcional usa el valor predeterminado del modelo.
openai/gpt-image-2.5-sunburst/edit| Nombre | Tipo | Obligatorio | Predeterminado |
|---|---|---|---|
| prompt | text | sí | - |
| images | url (image) | sí | - |
| aspect_ratio | 1:1 | 1:2 | 2:1 | 1:3 | 3:1 | 2:3 | ... | no | - |
| resolution | 1k | 2k | 4k | no | 1k |
| quality | low | medium | high | xhigh | max | no | medium |
| output_format | png | jpeg | webp | no | png |
3 · Inicia una generación
Una sola llamada calcula el precio de tus entradas exactas y lo cobra de tu saldo. La respuesta llega al instante con el estado queued y la generación se ejecuta en segundo plano. Envía una cabecera Idempotency-Key para que una solicitud repetida nunca cobre dos veces.
curl -X POST https://genlaxy.ai/api/v1/api/catalog/generations \
-H 'Authorization: Bearer gl_live_...' \
-H 'Content-Type: application/json' \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"modelId": "openai/gpt-image-2.5-sunburst/edit",
"inputs": {
"prompt": "a lighthouse on a cliff at dusk, soft light",
"images": [
"https://example.com/input.png"
]
}
}'Consulta primero el precio (opcional)
Las mismas entradas, con precio calculado sin iniciar nada. La respuesta está en céntimos.
curl -X POST https://genlaxy.ai/api/v1/api/catalog/quote \
-H 'Authorization: Bearer gl_live_...' \
-H 'Content-Type: application/json' \
-d '{"modelId":"openai/gpt-image-2.5-sunburst/edit","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light","images":["https://example.com/input.png"]}}'4 · Consulta y descarga
Pide la generación cada pocos segundos hasta que el estado sea succeeded, failed o refunded. Si tiene éxito, descarga el archivo desde contentUrl con la misma clave. Un modelo de texto devuelve su respuesta en textOutput.
curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID \
-H 'Authorization: Bearer gl_live_...'curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID/content \
-H 'Authorization: Bearer gl_live_...' \
-o result.pngEndpoints
URL base: https://genlaxy.ai/api/v1/api/catalog
| GET | /me | Tu clave y tu saldo |
| GET | /models | Todos los modelos |
| GET | /models/detail?id=MODEL_ID | Un modelo y sus campos |
| POST | /quote | Precio para entradas exactas |
| POST | /generations | Iniciar una generación |
| GET | /generations | Tus generaciones recientes |
| GET | /generations/ID | Estado de una generación |
| GET | /generations/ID/content | El archivo resultante |
| DELETE | /generations/ID | Eliminar una generación |
Precios y saldo
Las generaciones por API usan el mismo saldo que el estudio y cuestan lo mismo. Todos los importes de la API están en céntimos de euro: costCents es lo que cobró una generación y balanceCents lo que queda.
Errores y límites
Los errores llegan como JSON con un código y un mensaje. 401: clave ausente, incorrecta o revocada. 400: un campo no es válido (los detalles lo indican). 402: saldo insuficiente. 409 API_KEY_DAILY_CAP: se alcanzó el límite diario de la clave. 429: demasiadas solicitudes, reduce el ritmo. Una generación fallida se reembolsa automáticamente.