Générer des médias asynchrones
Créez des tâches de génération d'images, de vidéos ou de musique et récupérez leurs artefacts de manière asynchrone.
Soumettez des travaux de génération de médias de longue durée sans maintenir une requête d'inférence ouverte.
/v1/async-tasks/image-generationsCorps de la requête
| Champ | Type | Requis | Description |
|---|---|---|---|
model | string | Non | Identifiant du modèle de média. S'il est omis, le routage utilise le comportement du fournisseur par défaut configuré. |
prompt | string | Oui | Description de la sortie souhaitée. |
n | integer | Non | Nombre d'images de 1 à 10 ; par défaut 1. |
seed | integer | Non | Graine déterministe non négative lorsque prise en charge. |
| Champs supplémentaires | object | Non | Dimensions et contrôles de génération pris en charge par le fournisseur. Les champs de niveau supérieur inconnus sont rejetés ; les options spécifiques au fournisseur appartiennent à provider_options ou parameters. |
Les requêtes vidéo acceptent un duration_seconds positif jusqu'à 300 et un entier positif fps jusqu'à 120. Les requêtes musicales acceptent un duration_seconds jusqu'à 1 200 et nécessitent au moins l'un des prompt, lyrics ou title.
Cycle de vie de la tâche
- Soumettez une requête de génération d'image, de vidéo ou de musique.
- Stockez l'ID de tâche retourné.
- Sondez
GET /v1/async-tasks/{task_id}jusqu'à ce que la tâche soit terminée. - Téléchargez la sortie via l'URL de l'artefact signé.
Les URL d'artefacts sont limitées dans le temps. Conservez l'actif final dans votre propre stockage si une rétention à long terme est requise.
Alias de compatibilité
Les intégrations existantes peuvent utiliser /v1/images/generations, /v1/videos/generations et /v1/music/generations. Les nouvelles intégrations doivent utiliser les routes explicites /v1/async-tasks/*-generations ci-dessus.