POST /generate | ZUI GEN API Docs

POST/api/v1/generate

Crea una nueva tarea de generacion de contenido. Soporta generacion de imagenes, videos y audio.

Request

Headers

Header	Valor
`Authorization`	Bearer YOUR_API_KEY
`Content-Type`	application/json

Body Parameters

Parametro	Tipo	Requerido	Descripcion
`model`	string	Si	Identificador del modelo (ej: "flux/schnell", "kling/v1.6-pro")
`prompt`	string	Depende	Texto descriptivo para la generacion
`params`	object	No	Parametros especificos del modelo (aspect_ratio, duration, etc.)
`image_url`	string	Depende	URL de imagen de entrada (para modelos image-to-video o edicion)
`video_url`	string	Depende	URL de video de entrada (para modelos de extension o edicion)
`audio_url`	string	Depende	URL de audio de entrada

Ejemplo de Request

Generar imagen con FLUX

curl -X POST https://gen.zui.es/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \ 
  -H "Content-Type: application/json" \ 
  -d '{ 
    "model": "flux/schnell", 
    "prompt": "A futuristic city at sunset, cyberpunk style", 
    "params": { 
      "aspect_ratio": "16:9" 
    } 
  }'

Generar video con Kling

curl -X POST https://gen.zui.es/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \ 
  -H "Content-Type: application/json" \ 
  -d '{ 
    "model": "kling/v1.6-pro", 
    "prompt": "A cat playing piano in a jazz club", 
    "params": { 
      "duration": "5", 
      "aspect_ratio": "16:9" 
    } 
  }'

Image-to-Video con Sora

curl -X POST https://gen.zui.es/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \ 
  -H "Content-Type: application/json" \ 
  -d '{ 
    "model": "sora/standard", 
    "prompt": "The camera slowly zooms in", 
    "image_url": "https://example.com/my-image.jpg", 
    "params": { 
      "duration": "10" 
    } 
  }'

Response

200 OKjson

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "external_task_id": "ext_abc123",
  "status": "processing",
  "model": "flux/schnell",
  "category": "image",
  "credits_consumed": 5,
  "credits_remaining": 95
}

Campos de Respuesta

Campo	Tipo	Descripcion
`task_id`	string	UUID de la tarea (usar para consultar estado)
`external_task_id`	string	ID externo del proveedor
`status`	string	"processing" inicialmente
`model`	string	Modelo utilizado
`category`	string	"image", "video" o "audio"
`credits_consumed`	number	Creditos gastados en esta generacion
`credits_remaining`	number	Creditos restantes despues de la generacion

Errores

Codigo	HTTP	Descripcion
`MISSING_MODEL`	400	El parametro "model" es requerido
`INVALID_MODEL`	400	El modelo especificado no existe o no esta disponible
`INSUFFICIENT_CREDITS`	402	No tienes suficientes creditos para esta generacion
`GENERATION_ERROR`	500	Error interno al procesar la generacion

Siguiente paso

Una vez creada la tarea, usa el endpoint GET /api/v1/task/:taskId para consultar el estado y obtener los resultados cuando este completada.