Skip to main content
GET
cURL
Use este endpoint depois de criar uma tarefa de vídeo Flux 3. A resposta inclui video_url quando a tarefa é concluída.

Verifique estes campos

  • status é queued, in_progress, completed ou failed.
  • progress é uma porcentagem aproximada de conclusão de 0 a 100.
  • video_url aparece quando a tarefa é concluída.
  • error aparece quando a tarefa falha.

Consulte a tarefa

1

Primeiro, crie a tarefa

Comece com Criar um vídeo Flux 3 e armazene o id retornado.
2

Recupere o estado da tarefa

Envie o ID da tarefa para este endpoint até que status seja completed ou failed.
3

Baixe o arquivo MP4

Quando status for completed, chame Baixar conteúdo de vídeo Flux 3.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication. Use your CometAPI API key.

Parâmetros de caminho

task_id
string
obrigatório

Task ID returned by POST /v1/videos.

Resposta

Current Flux 3 video task state.

id
string
obrigatório

Task ID. Use this value as task_id in retrieve and content requests.

Exemplo:

"<task_id>"

object
string
obrigatório

Object type for the asynchronous video task.

Allowed value: "video"
model
string
obrigatório

Model ID that the task uses.

Allowed value: "flux-3"
status
enum<string>
obrigatório

Task lifecycle status. Poll until the value is completed or failed.

Opções disponíveis:
queued,
in_progress,
completed,
failed
progress
integer
obrigatório

Task progress as a coarse percentage.

Intervalo necessário: 0 <= x <= 100
created_at
integer<int64>
obrigatório

Task creation time as a Unix timestamp in seconds.

task_id
string

Compatibility alias for id. This field can be omitted from retrieve responses.

Exemplo:

"<task_id>"

completed_at
integer<int64>

Task completion time as a Unix timestamp in seconds when the task provides one.

expires_at
integer<int64>

Result expiration time as a Unix timestamp in seconds when the task provides one.

video_url
string<uri>

Video delivery URL. This field appears on completed tasks.

Exemplo:

"https://media.example.com/flux-3-result.mp4"

error
object

Failure details. This field appears when the task fails.

Última modificação em 14 de agosto de 2026