Generación de video doubao-seedance-1-5-pro

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-1-5-pro",
    "prompt": "A cute kitten playing in the sunlight, fluffy fur, bright eyes",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "audio": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

POST

videos

generations

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-1-5-pro",
    "prompt": "A cute kitten playing in the sunlight, fluffy fur, bright eyes",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "audio": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-1-5-pro",
    "prompt": "A cute kitten playing in the sunlight, fluffy fur, bright eyes",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "audio": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Autorización

Authorization

string

requerido

Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala a la cabecera de la solicitud:

Authorization: Bearer YOUR_API_KEY

Parámetros de la solicitud

model

string

requerido

Nombre del modelo de generación de videoModelos admitidos:

doubao-seedance-1-5-pro - Versión 1.5 Pro, admite generación de audio y primer/último fotograma

prompt

string

requerido

Descripción del contenido del videoDescriba escenas, acciones y estilos en detalle para obtener mejores resultadosEjemplo: "Atardecer en la playa, luz dorada del sol sobre el mar, olas rompiendo suavemente en la arena"

duration

integer

predeterminado:"5"

Duración del video (segundos)Rango admitido: 4 ~ 12 segundosPredeterminado: 5

aspect_ratio

string

predeterminado:"16:9"

Proporción del videoOpciones:

16:9 - Horizontal
9:16 - Vertical
1:1 - Cuadrado
4:3 - Proporción tradicional
3:4 - Proporción tradicional vertical
21:9 - Ultra ancha

Predeterminado: 16:9

resolution

string

predeterminado:"720p"

Resolución del videoOpciones:

480p - Definición estándar
720p - Alta definición
1080p - Full HD

Predeterminado: 720p

seed

integer

Semilla entera para controlar la aleatoriedad del contenido generadoRango de valores: número entero entre -1 y 2^32-1

Con la misma solicitud, si el modelo recibe valores de seed distintos (por ejemplo, no especificar seed o establecer seed en -1, lo que usará un número aleatorio), se generarán resultados diferentes
Con la misma solicitud, si el modelo recibe el mismo valor de seed, se generarán resultados similares, aunque no se garantiza que sean idénticos

audio

boolean

predeterminado:"false"

Si se debe generar audioCuando se establece en true, el video incluirá audio de acompañamiento generado por IAPredeterminado: false

La generación de audio es exclusiva de la versión 1.5 Pro; la versión 1.0 no admite este parámetro

camerafixed

boolean

predeterminado:"false"

Si se fija la cámaraCuando se establece en true, la posición de la cámara permanece fijaPredeterminado: false

Combinaciones de resolución y proporción

Resolución	Proporciones admitidas	Notas
480p	16:9, 4:3, 1:1, 3:4, 9:16, 21:9	Todas admitidas
720p	16:9, 4:3, 1:1, 3:4, 9:16, 21:9	Todas admitidas
1080p	16:9, 4:3, 1:1, 3:4, 9:16, 21:9	Todas admitidas

image_urls

array<url>

Array de URLs de imagen para generación imagen-a-videoReglas de asignación automática de rol:

1 imagen = primer fotograma
2 imágenes = primer fotograma + último fotograma

Ejemplo: ["https://example.com/first.png", "https://example.com/last.png"]

image_urls e image_with_roles no se pueden usar al mismo tiempo

image_with_roles

array

Array de imágenes con roles para un control más preciso

Mostrar Descripción de los campos

url

string

requerido

URL de la imagen

role

string

requerido

Rol de la imagenOpciones:

first_frame - Imagen del primer fotograma, como fotograma inicial del video (solo se admite una)
last_frame - Imagen del último fotograma, como fotograma final del video (solo se admite una)

Ejemplo:

[
  {"url": "https://example.com/start.png", "role": "first_frame"},
  {"url": "https://example.com/end.png", "role": "last_frame"}
]

image_urls e image_with_roles no se pueden usar al mismo tiempo
El primer fotograma y el último fotograma solo admiten uno cada uno

Respuesta

code

integer

Código de estado de la respuesta, 200 en caso de éxito

data

array

Array de datos de la respuesta

Mostrar Elementos del array

status

string

Estado de la tarea, submitted cuando se envía inicialmente

task_id

string

Identificador único de la tarea para consultar el estado y los resultados

Casos de uso

Caso 1: Texto-a-video con audio

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand",
  "audio": true
}

Caso 2: Video corto vertical de alta calidad

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "A girl spinning under cherry blossom trees, petals falling with the wind",
  "duration": 5,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "audio": true
}

Caso 3: Video dinámico a partir del primer fotograma

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "Animate the image with natural dynamic effects",
  "image_urls": ["https://example.com/first.png"],
  "duration": 5,
  "audio": true
}

Caso 4: Efecto de transición con primer/último fotograma

{
  "model": "doubao-seedance-1-5-pro",
  "prompt": "Scene transitions from day to night, city lights gradually turning on",
  "image_with_roles": [
    {"url": "https://example.com/day.png", "role": "first_frame"},
    {"url": "https://example.com/night.png", "role": "last_frame"}
  ],
  "duration": 5
}

Consultar los resultados de la tareaLa generación de video es una tarea asíncrona que devuelve un task_id al enviarla. Use el endpoint Obtener estado de tarea para consultar el progreso y los resultados de la generación.

Diferencias con la versión 1.0

Característica	1.0 fast/quality	1.5 Pro
Resolución predeterminada	1080p	720p
Resoluciones admitidas	480p/720p/1080p	480p/720p/1080p
Rango de duración	2-12s	4-12s
Generación de audio	No admitida	Admitida
Imagen de referencia	`reference` (1 imagen)	No admitida

Generación de video doubao-seedance-1-0-pro Generación de video doubao-seedance-2.0

Documentation Index

​Autorización

​Parámetros de la solicitud

​Combinaciones de resolución y proporción

​Respuesta

​Casos de uso

​Caso 1: Texto-a-video con audio

​Caso 2: Video corto vertical de alta calidad

​Caso 3: Video dinámico a partir del primer fotograma

​Caso 4: Efecto de transición con primer/último fotograma

​Diferencias con la versión 1.0

Autorización

Parámetros de la solicitud

Combinaciones de resolución y proporción

Respuesta

Casos de uso

Caso 1: Texto-a-video con audio

Caso 2: Video corto vertical de alta calidad

Caso 3: Video dinámico a partir del primer fotograma

Caso 4: Efecto de transición con primer/último fotograma

Diferencias con la versión 1.0