Seedance 2.5 · Generar vídeo

Endpoint	Método	Ruta
Enviar tarea	POST	/v1/videos/generations
Consultar resultado	GET	/v1/videos/generations/{id}

Parámetros de solicitud

Authorization

Añade un header Authorization cuyo valor sea Bearer seguido de tu API key.

Authorization: Bearer ****************

Parámetros de header

Content-TypestringOpcional

application/json

AcceptstringOpcional

application/json

Parámetros de bodyapplication/jsonobligatorio

modelstringObligatorio

ID del modelo, fijo en `dreamina-seedance-2.5`

contentarray[object]Obligatorio

Array de entrada nativo de BytePlus (uso principal recomendado); combina los 5 tipos de abajo. Ten en cuenta que role va a nivel del elemento de content junto a type, NO dentro del sub-objeto image_url/video_url. Roles: imagen first_frame/last_frame/reference_image; vídeo reference_video.

callback_urlstringOpcional

URL de callback al cambiar el estado de la tarea (opcional)

return_last_framebooleanOpcional

Si devolver la imagen del último fotograma (por defecto false)

resolutionstringOpcional

480p / 720p / 1080p / 4kResolución del vídeo (por defecto 720p; 4k solo en Seedance 2.0)

ratiostringOpcional

16:9 / 4:3 / 1:1 / 9:16 / 21:9 / adaptiveRelación de aspecto del vídeo generado (por defecto adaptive)

durationintegerOpcional

Duración del vídeo en segundos (por defecto 5)

seedintegerOpcional

Semilla aleatoria, por defecto -1 (aleatoria); rango [-1, 2^32-1]

camera_fixedbooleanOpcional

Si la cámara está fija (por defecto false)

watermarkbooleanOpcional

Si añadir marca de agua (por defecto false)

service_tierstringOpcional

default / flexNivel de servicio: default (inferencia en línea) / flex (offline, mitad de precio; no soportado en Seedance 2.0)

execution_expires_afterintegerOpcional

Tiempo de espera de la tarea (segundos) desde created_at; por defecto 172800 (48h), rango [3600, 259200]

generate_audiobooleanOpcional

Si la salida incluye audio sincronizado (por defecto true; solo Seedance 2.0 / 1.5 Pro)

draftbooleanOpcional

Activar modo borrador (por defecto false; solo Seedance 1.5 Pro; borrador fijo a 480p)

safety_identifierstringOpcional

Identificador único del usuario final para el control de riesgos de la plataforma

Ejemplo

{
  "model": "dreamina-seedance-2.5",
  "content": [
    {
      "type": "text",
      "text": "Olas rompiendo contra las rocas a cámara lenta, tonos cálidos del atardecer"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "seed": 11,
  "camera_fixed": false,
  "watermark": false
}

{  "model": "dreamina-seedance-2.5",  "content": [    {      "type": "text",      "text": "Olas rompiendo contra las rocas a cámara lenta, tonos cálidos del atardecer"    }  ],  "resolution": "720p",  "ratio": "16:9",  "duration": 5,  "seed": 11,  "camera_fixed": false,  "watermark": false}

Código de ejemplo

curl https://api.hotrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2.5",
    "content": [
      {
        "type": "text",
        "text": "Olas rompiendo contra las rocas a cámara lenta, tonos cálidos del atardecer"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "seed": 11,
    "camera_fixed": false,
    "watermark": false
  }'

curl https://api.hotrouter.ai/v1/videos/generations \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "dreamina-seedance-2.5",    "content": [      {        "type": "text",        "text": "Olas rompiendo contra las rocas a cámara lenta, tonos cálidos del atardecer"      }    ],    "resolution": "720p",    "ratio": "16:9",    "duration": 5,    "seed": 11,    "camera_fixed": false,    "watermark": false  }'

Respuesta

Enviar tarea

{
  "id": "cgt-xxxxxxxx",
  "status": "queued"
}

{  "id": "cgt-xxxxxxxx",  "status": "queued"}

Consultar resultado

{
  "id": "cgt-xxxxxxxx",
  "status": "succeeded",
  "content": {
    "video_url": "https://.../video.mp4"
  },
  "usage": {
    "completion_tokens": 0
  }
}

{  "id": "cgt-xxxxxxxx",  "status": "succeeded",  "content": {    "video_url": "https://.../video.mp4"  },  "usage": {    "completion_tokens": 0  }}

Seedance 2.5 · Generar vídeo

Parámetros de solicitud

Código de ejemplo

Respuesta

On this page