Endpoints/Media

Obtener tarea de medios

Recupera el estado y el resultado de una tarea de medios asíncrona por su id. Consulta este endpoint hasta que el estado sea succeeded o failed.

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

#Autenticación

Todas las solicitudes llevan tu clave en el encabezado Authorization.

http

Authorization: Bearer sk-corr-...

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	Sí	El id de tarea devuelto por el endpoint de creación de tareas.

bash

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

Devuelve el objeto de tarea. Campos comunes:

Campo	Tipo	Descripción
`id`	string	Obtener tarea de medios id
`status`	string	Estado de la tarea: queued / submitted / succeeded / failed / timeout.
`type`	string	Tipo de medio: image / video / music.
`model`	string	El modelo que solicitaste.
`result.urls`	string[]	Presente en caso de éxito. result.urls es un array de URL de archivo permanentes.
`error`	string	Mensaje de error, presente cuando la tarea falló.
`cost`	string	Importe cobrado por esta tarea: una cadena en USD (p. ej. "0.1200"). Consulta el campo currency.

Ejemplos de respuesta

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

status	Descripción
`queued`	En cola, esperando para iniciar.
`running`	Generando en el proveedor upstream.
`succeeded`	Listo: result.urls está disponible.
`failed`	Fallido: consulta error. La retención se reembolsa automáticamente.

Presente en caso de éxito. result.urls es un array de URL de archivo permanentes.

Estado	Significado
`401`	Clave inválida o ausente
`404`	El modelo solicitado no existe o no está disponible

json

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