Desarrolladores · API v1

Una API.
Todos los modelos.

Imágenes, vídeo, audio y 3D tras una sola API, con el mismo saldo que el estudio. Crea una clave en Ajustes e instala la CLI con npm.

Obtener una clave APIInicio rápido
Instalar la CLI
npm i -g ineveo
Modelos
699
Endpoints
9
Recarga mínima
3 €
01 · Ejemplos

La misma llamada, cualquier resultado

Cambia el ID del modelo para pasar de imagen a video o voz. Los campos dependen del modelo.

1# 1. Generate an image2curl -X POST https://ineveo.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $INEVEO_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://ineveo.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $INEVEO_API_KEY"17 18# 3. Download the file19curl https://ineveo.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $INEVEO_API_KEY" \21  -o result.jpeg
Render de ejemploluma/uni-v1/text-to-image
[02] Inicio rápido

Tu primer render en tres pasos

  1. 01Crea una clave de APIInicia sesión con tu email, abre Ajustes, Claves de API y crea una clave. Recarga desde 3 € en Facturación.export INEVEO_API_KEY="YOUR_API_KEY"
  2. 02Instala la CLIUn solo comando: npm i -g ineveo. Lee tu clave de INEVEO_API_KEY.npm i -g ineveo
  3. 03Haz tu primer renderElige un ID de modelo del catálogo y envía un prompt. Añade --dry-run para ver el precio sin gastar nada.ineveo run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
[03] CLI

Renderiza desde la terminal

Ejecuta cualquier modelo desde una shell, un job de CI o un agente de código. Cada render se cotiza antes de empezar y se cobra del mismo saldo.

Scripts y CICada campo de un modelo es un flag; un archivo local se sube por ti.
JSON en stdoutUn documento JSON por ejecución, progreso y errores en stderr, código de salida distinto de cero si falla.
Agentes de códigoUn archivo de skill enseña a tu agente a consultar primero el precio y a limitarlo.
Guía completa de la CLI →
ComandoQué hace
ineveo models --type videoTodos los modelos de video con su precio inicial
ineveo run <model> -hLos campos de un modelo, en vivo: tipo, valor por defecto, valores permitidos
ineveo run <model> -p "<prompt>" -o ./out/Renderiza y guarda el resultado en una carpeta
ineveo run <model> -p "..." --dry-runEl precio exacto, sin gastar nada
ineveo run <model> -p "..." --max-price 0.50No ejecuta si el precio es mayor
ineveo run <model> -p "..." --json -o ./out/Un resultado JSON, listo para el siguiente paso
ineveo skill installEnseña a tu agente de código a usar la CLI
[04] Lo esencial de la API

Lista para producción

Autenticación

Un token Bearer en el encabezado Authorization. Crea claves en Ajustes y revoca cualquiera en cualquier momento.

Authorization: Bearer YOUR_API_KEY

Renders en segundo plano

Iniciar un render responde al instante con el estado queued. Consulta el render hasta que termine con éxito, falle o se reembolse.

{ "status": "queued" }

Primero el precio

Pide el precio exacto de tus parámetros sin iniciar nada. Todos los importes están en céntimos de euro.

POST /api/v1/api/catalog/quote

Reintentos seguros

Envía un encabezado Idempotency-Key y una petición repetida nunca cobra dos veces.

Idempotency-Key: render-042

Límites

Cada clave tiene un límite por minuto y un tope diario opcional. Al superarlo, la API responde 429.

429 Too Many Requests

Errores y reembolsos

Errores JSON con un código y un mensaje. Un render fallido se reembolsa a tu saldo automáticamente.

{ "status": "refunded" }
[05] Referencia

Endpoints

URL base https://ineveo.com/api/v1

Referencia completa de la API →
GET/api/catalog/meTu clave y tu saldo
GET/api/catalog/modelsTodos los modelos
GET/api/catalog/models/detail?id=MODEL_IDUn modelo y sus campos
POST/api/catalog/quotePrecio para entradas exactas
POST/api/catalog/generationsIniciar una generación
GET/api/catalog/generationsTus generaciones recientes
GET/api/catalog/generations/IDEstado de una generación
GET/api/catalog/generations/ID/contentEl archivo resultante
DELETE/api/catalog/generations/IDEliminar una generación

Recarga 3 € y lanza hoy

Crea una clave API en Ajustes y llama a cualquier modelo. La CLI está disponible en npm. Los renders fallidos se reembolsan.

Obtener una clave APIVer precios