Generación de vídeo

POST/v1/media/videos

Endpoint de vídeo propio: un único endpoint para texto-a-vídeo e imagen-a-vídeo. Asíncrono: devuelve un task id — consulta GET /v1/media/videos/{id} para obtener el resultado. Se factura por duración de salida.

Cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
`model`	string	Sí	Modelo de vídeo a usar (de GET /v1/models).
`prompt`	string	No	Descripción textual. Se requiere prompt o references.
`resolution`	string	No	Resolución, p. ej. 720P o 1280x720.
`ratio`	string	No	Relación de aspecto, p. ej. 16:9.
`duration`	integer	No	Duración del clip en segundos.
`audio`	boolean	No	Si se genera sonido (depende del modelo, p. ej. seedance con/sin sonido).
`references`	object or array	No	Entrada(s) de referencia: {type, url, mime_type?} o un array. type es uno de first_frame, last_frame, image, video, audio, mask, style, character, pose, depth, control. (También se acepta el atajo image.)
`provider_options`	object	No	Interruptores específicos del proveedor, reenviados al upstream sin cambios.

Se requiere prompt o references.

Ejemplo de solicitud

bash

curl https://api.apexnova-consulting.com/v1/media/videos \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-1.0-pro",
    "prompt": "Aerial drone shot of a sunrise over the sea",
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5
  }'

python

import requests

resp = requests.post(
    "https://api.apexnova-consulting.com/v1/media/videos",
    headers={"Authorization": "Bearer sk-xxxxxxxx"},
    json={
        "model": "seedance-1.0-pro",
        "prompt": "Aerial drone shot of a sunrise over the sea",
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 5,
    },
)
task = resp.json()
print(task["id"], task["status"])

Ejemplo de respuesta

json

{
  "id": "68a1f0c2-...",
  "object": "media.video",
  "model": "seedance-1.0-pro",
  "status": "processing",
  "created": 1234567890
}

Imagen-a-vídeo (entrada de referencia)

Pasa medios de entrada en references para cambiar a imagen-a-vídeo; p. ej. usa first_frame para animar una imagen fija.

bash

curl https://api.apexnova-consulting.com/v1/media/videos \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-1.0-pro",
    "prompt": "Slow zoom out with gentle camera motion",
    "references": [
      { "type": "first_frame", "url": "https://example.com/first.png" }
    ],
    "resolution": "720P",
    "duration": 5
  }'