Endpoints/Media

Obter tarefa de multimédia

Obtenha o estado e o resultado de uma tarefa de multimédia assíncrona pelo seu id. Consulte este endpoint até o estado ser succeeded ou failed.

GEThttps://api.foxwire.ai/v1/media/generations/{id}

#Autenticação

Todos os pedidos levam a sua chave no cabeçalho Authorization.

http

Authorization: Bearer sk-corr-...

Parâmetro	Tipo	Obrigatório	Descrição
`id`	string	Sim	O id de tarefa devolvido pelo endpoint de criação de tarefas.

bash

curl https://api.foxwire.ai/v1/media/generations/task_abc123 \
  -H "Authorization: Bearer $CORRY_KEY"

Devolve o objeto de tarefa. Campos comuns:

Campo	Tipo	Descrição
`id`	string	Obter tarefa de multimédia id
`status`	string	Estado da tarefa: queued / submitted / succeeded / failed / timeout.
`type`	string	Tipo de multimédia: image / video / music.
`model`	string	O modelo que solicitou.
`result.urls`	string[]	Presente em caso de sucesso. result.urls é um array de URLs de ficheiro permanentes.
`error`	string	Mensagem de erro, presente quando a tarefa falhou.
`cost`	string	Montante cobrado por esta tarefa — uma string em USD (ex.: "0.1200"). Consulte o campo currency.

Exemplos de resposta

{
  "id": "task_abc123",
  "status": "running",
  "type": "image",
  "model": "gpt-image-2"
}

status	Descrição
`queued`	Em fila, a aguardar início.
`running`	A gerar no fornecedor upstream.
`succeeded`	Concluído — result.urls está disponível.
`failed`	Falhou — consulte error. A reserva é reembolsada automaticamente.

Presente em caso de sucesso. result.urls é um array de URLs de ficheiro permanentes.

Estado	Significado
`401`	Chave inválida ou em falta
`404`	O modelo solicitado não existe ou não está disponível

json

{
  "error": {
    "message": "Task not found",
    "type": "not_found"
  }
}