Apexnova Consulting

Consultar una tarea de vídeo

GET/v1/media/videos/{id}

Consulta el estado y el resultado de una tarea asíncrona de generación de vídeo.

Parámetros de ruta

CampoTipoRequeridoDescripción
idstring (path)El task id devuelto por POST /v1/media/videos.

Ejemplo de solicitud

bash
curl https://api.apexnova-consulting.com/v1/media/videos/68a1f0c2-abc123 \
  -H "Authorization: Bearer sk-xxxxxxxx"
python
import time
import requests

headers = {"Authorization": "Bearer sk-xxxxxxxx"}
url = "https://api.apexnova-consulting.com/v1/media/videos/68a1f0c2-abc123"

while True:
    task = requests.get(url, headers=headers).json()
    if task["status"] in ("succeeded", "failed"):
        break
    time.sleep(3)

print(task)

Ejemplo de respuesta

json
{
  "id": "68a1f0c2-...",
  "object": "media.video",
  "model": "seedance-1.0-pro",
  "status": "succeeded",
  "created": 1234567890,
  "data": [
    {
      "url": "https://...",
      "duration_seconds": 5,
      "resolution": "720P",
      "ratio": "16:9"
    }
  ]
}

status es uno de pending, processing, succeeded o failed. En caso de éxito, data[0].url contiene la URL del vídeo; en caso de fallo, error.message explica el motivo.