API de Genlaxy: cualquier modelo desde tu propio código

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

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.

Modelo seleccionadomureka-ai/mureka-v7.6/recognize-song

Página del modelo →

Campos
Nombre	Tipo	Obligatorio	Predeterminado
audio	url (audio)	sí	-

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

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": "mureka-ai/mureka-v7.6/recognize-song",
  "inputs": {
    "audio": "https://example.com/input.mp3"
  }
}'

Consulta primero el precio (opcional)

Las mismas entradas, con precio calculado sin iniciar nada. La respuesta está en céntimos.

curl

curl -X POST https://genlaxy.ai/api/v1/api/catalog/quote \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"modelId":"mureka-ai/mureka-v7.6/recognize-song","inputs":{"audio":"https://example.com/input.mp3"}}'

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

curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID \
  -H 'Authorization: Bearer gl_live_...'

curl

curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID/content \
  -H 'Authorization: Bearer gl_live_...' \
  -o result.mp3

Endpoints

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.