curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
}'
import requests
payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": True,
"nsfw_check": True,
"return_last_frame": True
}
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
seedance-2-5-flash
Generación de vídeo Seedance 2.5 Flash
Genera vídeos 480p / 720p de hasta 30 segundos mediante texto, referencias multimodales, edición, extensión o fotogramas iniciales y finales.
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
}'
import requests
payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": True,
"nsfw_check": True,
"return_last_frame": True
}
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
curl --request POST \
--url https://api.apimart.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
}'
import requests
payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": True,
"nsfw_check": True,
"return_last_frame": True
}
response = requests.post(
"https://api.apimart.ai/v1/videos/generations",
headers={"Authorization": "Bearer <token>"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())
const payload = {
"model": "seedance-2-5-flash",
"prompt": "A cinematic shot of a fox walking through a sunlit forest, with a slow tracking camera",
"resolution": "720p",
"size": "16:9",
"duration": 8,
"generate_audio": true,
"nsfw_check": true,
"return_last_frame": true
};
const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "task_example_seedance25flash"
}
]
}
POST /v1/videos/generations, lee data[0].task_id y consulta GET /v1/tasks/{task_id}.
Parámetros de solicitud
Usa
seedance-2-5-flash. También se admite doubao-seedance-2-5-flash. El nombre con punto seedance-2.5-flash no es compatible.Indica si se debe moderar el contenido antes de enviar la tarea de vídeo.
true: revisar los prompts y las imágenes de entrada conomni-moderation-latestfalseu omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
nsfw_content_detected) sin crear tarea ni cobrar la generación. No se revisan vídeos ni audios de referencia. La solicitud puede continuar si falla el servicio de moderación.Prompt obligatorio. Referencia medios con
@图片1 / @视频1 / @音频1; los índices empiezan en 1 y siguen el orden de cada matriz de medios.Solo
480p / 720p; valor predeterminado 720p. 1080p, 2k, 4k y otros valores devuelven HTTP 400 al enviar.Admite
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive (predeterminado). Alias: aspect_ratio. Los fotogramas inicial/final, la edición y la extensión requieren adaptive.Segundos enteros
4–30; las solicitudes normales usan 5 si se omite. -1 permite duración automática. edit explícito solo acepta -1 u omisión, que se convierte en -1; la salida sigue la duración de origen. La duración automática reserva 30 segundos y se liquida según los tokens reales.Generar sonido,
true por defecto. Alias: audio. Controla la salida, no las referencias de entrada audio_urls.auto (predeterminado), reference, edit o extend, solo en tareas con referencias. Los tipos explícitos activan las validaciones al enviar descritas a continuación.Matriz de imágenes, todas como
reference_image. Máximo 10 combinadas con image_with_roles. Usa este último campo para los fotogramas inicial y final.Cada elemento incluye
url y role. Roles: reference_image, first_frame (máximo 1), last_frame (máximo 1, junto al inicial). Máximo 10 imágenes con image_urls; evita roles contradictorios. Con video_urls / audio_urls, los fotogramas inicial/final se convierten en imágenes de referencia multimodal.Máximo 5 vídeos, de 2–30 segundos cada uno y 30 segundos en total. Los vídeos de origen para edición deben durar 4–30 segundos.
Máximo 5 audios, de 2–30 segundos cada uno y 30 segundos en total. Se admiten referencias solo de audio, sin imágenes ni vídeos.
Con
true, devuelve una imagen del último fotograma tras el éxito en data.result.videos[].last_frame_url.No se admiten
draft / draft_task_id; elimínalos de la solicitud o recibirás HTTP 400. Para borradores usa Seedance 2.5.Requisitos de los medios
Usa URLhttp(s) públicas o ID asset:// aprobados. La resolución de salida y los límites de píxeles del vídeo de entrada se validan por separado.
| Medio | Límites |
|---|---|
| Imágenes | ≤10 entre ambos campos; JPEG / PNG / WebP / BMP / TIFF / GIF / HEIC / HEIF; ancho y alto de 300–6000 px cada uno; proporción 0.4–2.5; <30 MB cada una. |
| Vídeos | ≤5; MP4 / MOV, vídeo H.264 / H.265 y audio AAC / MP3; 2–30 segundos cada uno, ≤30 segundos en total; ≤200 MB cada uno; ancho y alto 300–6000 px, proporción 0.4–2.5, ancho × alto 409,600–8,295,044 píxeles, 24–60 FPS. |
| Audio | ≤5; WAV / MP3; 2–30 segundos cada uno, ≤30 segundos en total; ≤15 MB cada uno. |
Tipos de tarea y restricciones
| Modo | Uso y restricciones |
|---|---|
| Texto a vídeo | Proporciona prompt sin referencias y omite omni_reference_task_type. |
| Referencias a vídeo | Proporciona referencias; reference es opcional. Se mantienen los límites normales de duración y proporción. |
| Fotogramas inicial/final | Usa image_with_roles; size / aspect_ratio debe ser adaptive. |
| Edición de vídeo | edit; al menos 1 vídeo de origen de 4–30 segundos; proporción adaptive, duration en -1 u omitido. |
| Extensión de vídeo | extend; al menos 1 vídeo de referencia; proporción adaptive. |
auto, el modelo deduce el tipo de los medios y el prompt, por lo que puede fallar durante la generación. Un tipo explícito también puede producir InvalidParameter.TaskTypeMismatch si contradice el prompt.
Ejemplos de solicitudes
Referencia multimodal
{
"model": "seedance-2-5-flash",
"prompt": "Use the composition of @视频1, the subject in @图片1, and @音频1 as background music",
"image_urls": [
"https://example.com/reference.jpg"
],
"video_urls": [
"https://example.com/reference_8s.mp4"
],
"audio_urls": [
"https://example.com/music_5s.mp3"
],
"omni_reference_task_type": "reference",
"duration": 8,
"size": "16:9"
}
Fotogramas inicial y final
{
"model": "seedance-2-5-flash",
"prompt": "Smoothly transition from the first frame to the last frame",
"image_with_roles": [
{
"url": "https://example.com/first.jpg",
"role": "first_frame"
},
{
"url": "https://example.com/last.jpg",
"role": "last_frame"
}
],
"size": "adaptive",
"duration": 5
}
Edición de vídeo
{
"model": "seedance-2-5-flash",
"prompt": "Edit @视频1: replace the cloudy sky with a clear sunset while preserving the camera movement",
"video_urls": [
"https://example.com/source_10s.mp4"
],
"omni_reference_task_type": "edit",
"size": "adaptive",
"duration": -1,
"output_format": "mov"
}
Extensión de vídeo
{
"model": "seedance-2-5-flash",
"prompt": "Extend @视频1 forward: continue the camera movement as the subject walks into the forest",
"video_urls": [
"https://example.com/source_10s.mp4"
],
"omni_reference_task_type": "extend",
"size": "adaptive",
"duration": 5
}
Recursos privados
Aprueba primero en la biblioteca las imágenes o vídeos con rostros reales y después usaasset://. En la carga, model también debe ser seedance-2-5-flash. Consulta la API de recursos y usa el nombre Flash del ejemplo.
curl --request POST \
--url https://api.apimart.ai/v1/seedance2/private-avatar/assets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2-5-flash",
"group": {
"name": "flash-assets"
},
"asset_type": "Image",
"assets": [
{
"url": "https://example.com/reference.jpg",
"name": "reference"
}
]
}'
asset:// de la lista y úsalo en image_urls, image_with_roles[].url, video_urls o audio_urls.
Estado y resultados
Consulta la API de estado.pending / processing indican progreso, completed éxito y failed fallo. Lee data.result.videos[0].url[0]; url es una matriz.
curl --request GET \
--url 'https://api.apimart.ai/v1/tasks/task_example_seedance25flash' \
--header 'Authorization: Bearer <token>'
{
"code": 200,
"data": {
"id": "task_example_seedance25flash",
"status": "completed",
"progress": 100,
"cost": 0.3104,
"credits_cost": 3.104,
"usage": {
"completion_tokens": 38800
},
"result": {
"videos": [
{
"url": [
"https://example.com/generated-video.mp4"
],
"last_frame_url": "https://example.com/generated-last-frame.png"
}
]
}
}
}
| Campo | Significado |
|---|---|
data.usage.completion_tokens | Tokens para la liquidación final. Pueden faltar durante unos segundos tras finalizar; vuelve a consultar. |
data.cost | Cargo real en USD con los descuentos de la cuenta. Usa el valor devuelto. |
data.credits_cost | Créditos realmente cobrados. |
data.result.videos[].url | Matriz de URL de vídeo; descarga y guarda pronto. |
data.result.videos[].last_frame_url | URL del último fotograma, solo tras éxito con return_last_frame: true. |
data.error.message | Motivo del fallo. En tareas fallidas, data.cost es 0 y se reembolsa la reserva. |
Facturación
- Al enviar se reserva un importe con la tarifa por segundo de la resolución. Las referencias de vídeo usan el nivel con entrada y suman duración de salida y duración total de referencias.
- Sin
duration, una solicitud normal reserva 5 segundos de salida.duration: -1, oeditsin duración, reserva 30 segundos de salida. - Tras el éxito:
data.usage.completion_tokens÷ 1,000,000 × tarifa aplicable por millón de tokens, con descuentos de cuenta. Se reembolsa o cobra la diferencia. La presencia de vídeo de referencia determinatokenotoken-input; el cargo final esdata.cost. - Los envíos rechazados no generan cargos de generación. Si la generación falla, se reembolsa la reserva. Consulta la página de precios.
Errores frecuentes
| Situación | Acción |
|---|---|
| HTTP 400: resolución no compatible | Usa 480p / 720p, no 1080p. |
| HTTP 400: demasiadas referencias | Máximo 10 imágenes combinadas, 5 vídeos y 5 audios; comprueba también las duraciones. |
| HTTP 400: borrador no compatible | Elimina draft / draft_task_id. |
| HTTP 400: tipo, duración o proporción | Revisa omni_reference_task_type, duration, size / aspect_ratio. |
HTTP 400: nsfw_content_detected | Trátalo como rechazo de moderación; lee error.message y modifica el contenido. |
| Modelo no encontrado | Usa seedance-2-5-flash, no seedance-2.5-flash. |
Tarea failed | Lee data.error.message y ajusta medios y prompt al tipo de tarea. Se reembolsa la reserva. |