Generar medios asíncronos
Crea trabajos de generación de imágenes, vídeos o música y recupera sus artefactos de forma asíncrona.
Envía trabajos de generación de medios de larga duración sin mantener abierta una solicitud de inferencia.
/v1/async-tasks/image-generationsCuerpo de la solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
model | string | No | Identificador del modelo de medios. Si se omite, el enrutamiento utiliza el comportamiento del proveedor predeterminado configurado. |
prompt | string | Sí | Descripción de la salida deseada. |
n | integer | No | Número de imágenes de 1 a 10; el valor predeterminado es 1. |
seed | integer | No | Semilla determinista no negativa cuando se admite. |
| Campos adicionales | object | No | Dimensiones admitidas por el proveedor y controles de generación. Los campos de nivel superior desconocidos se rechazan; las opciones específicas del proveedor pertenecen a provider_options o parameters. |
Las solicitudes de vídeo aceptan un duration_seconds positivo de hasta 300 y un entero positivo fps de hasta 120. Las solicitudes de música aceptan duration_seconds de hasta 1200 y requieren al menos uno de prompt, lyrics o title.
Ciclo de vida de la tarea
- Envía una solicitud de generación de imágenes, vídeo o música.
- Almacena el ID de tarea devuelto.
- Sondea
GET /v1/async-tasks/{task_id}hasta que la tarea se complete. - Descarga la salida a través de la URL de artefacto firmada.
Las URL de artefactos tienen un tiempo limitado. Persiste el activo final en tu propio almacenamiento cuando se requiera retención a largo plazo.
Alias de compatibilidad
Las integraciones existentes pueden usar /v1/images/generations, /v1/videos/generations y /v1/music/generations. Las nuevas integraciones deben usar las rutas explícitas /v1/async-tasks/*-generations anteriores.