Gerar Mídia Assíncrona

Envie trabalhos de geração de mídia de longa duração sem manter uma solicitação de inferência aberta.

POST/v1/async-tasks/image-generations

Corpo da Solicitação

Campo	Tipo	Obrigatório	Descrição
`model`	string	Não	Identificador do modelo de mídia. Quando omitido, o roteamento usa o comportamento do provedor padrão configurado.
`prompt`	string	Sim	Descrição da saída desejada.
`n`	integer	Não	Contagem de imagens de 1 a 10; o padrão é 1.
`seed`	integer	Não	Semente determinística não negativa quando suportada.
Campos Adicionais	object	Não	Dimensões e controles de geração suportados pelo provedor. Campos de nível superior desconhecidos são rejeitados; opções específicas do provedor pertencem a `provider_options` ou `parameters`.

Solicitações de vídeo aceitam um duration_seconds positivo de até 300 e um inteiro positivo fps de até 120. Solicitações de música aceitam duration_seconds de até 1.200 e exigem pelo menos um de prompt, lyrics ou title.

Ciclo de Vida da Tarefa

Envie uma solicitação de geração de imagem, vídeo ou música.
Armazene o ID da tarefa retornado.
Consulte GET /v1/async-tasks/{task_id} até que a tarefa seja concluída.
Baixe a saída através do URL assinado do artefato.

Os URLs de artefato têm tempo limitado. Persista o ativo final em seu próprio armazenamento quando o armazenamento de longo prazo for necessário.

Aliases de Compatibilidade

Integrações existentes podem usar /v1/images/generations, /v1/videos/generations e /v1/music/generations. Novas integrações devem usar as rotas explícitas /v1/async-tasks/*-generations acima.