Coloca na fila uma geração. kind image: prompt, aspect (square 1080x1080, portrait 1080x1350, story 1080x1920, landscape 1920x1080), model e até 16 referenceMediaIds de imagens. kind music: prompt e model (clipes de cerca de 30 s). kind voice: prompt com o roteiro exato, model e voice opcional. kind sfx: prompt descrevendo o efeito sonoro (whoosh, impacto, riser, clique, ambiente), model e durationMs de 500 a 22000; o efeito chega sem silêncio nas pontas e nunca passa de durationMs. kind video: aspect e video, uma linha do tempo (durationMs até 90000, background #rrggbb, faixas visual de baixo para cima e audio, cada clipe com mediaId da biblioteca, startMs, durationMs, trimInMs, fit cover ou contain, transform normalizado de 0 a 1 com centro, volume de 0 a 2 e fades; clipes de uma faixa não se sobrepõem); sem model. kind cutout (remove o fundo de uma imagem, PNG transparente), captions (legendas WebVTT da fala de um áudio ou vídeo), denoise (áudio limpo de um áudio ou vídeo) e proxy (cópia de edição de um vídeo em até 720p com um quadro chave a cada meio segundo, fora da biblioteca; uma cópia pronta da mesma origem é devolvida de novo sem reprocessar): sourceMediaId da biblioteca, sem model; processados na plataforma, no máximo 2 ao mesmo tempo por workspace (429 too_many_jobs). Campos inválidos respondem 422 invalid_request com o código de cada campo em details. Responde 202 com o job; acompanhe por GET /v1/media/generations/{id}. Imagem, música, locução e efeito sonoro são cobrados do saldo pelo custo informado pelo provedor; o resultado só é entregue depois de cobrado (status settling enquanto o provedor não informa o custo). Um pedido igual do mesmo usuário ainda em andamento devolve o mesmo job sem nova cobrança. O cabeçalho Idempotency-Key é obrigatório: repetir a chave com o mesmo corpo devolve a mesma resposta, sem outro job nem outra cobrança.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||