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
Génération vidéo Seedance 2.5 Flash
Créez des vidéos 480p / 720p de 30 secondes maximum à partir de texte, de références multimodales, par édition, extension ou images de début et de fin.
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, récupérez data[0].task_id, puis interrogez GET /v1/tasks/{task_id}.
Paramètres de requête
Utilisez
seedance-2-5-flash. L’alias doubao-seedance-2-5-flash est également accepté. Le nom avec un point seedance-2.5-flash n’est pas pris en charge.Indique s’il faut modérer le contenu avant d’envoyer la tâche vidéo.
true: vérifier les prompts et les images d’entrée avecomni-moderation-latestfalseou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
nsfw_content_detected) sans créer de tâche ni facturer la génération. Les vidéos et sons de référence ne sont pas examinés. La requête peut continuer si le service de modération échoue.Prompt obligatoire. Référencez les médias avec
@图片1 / @视频1 / @音频1 ; les indices commencent à 1 et suivent l’ordre de chaque tableau de médias.Uniquement
480p / 720p, avec 720p par défaut. 1080p, 2k, 4k et les autres valeurs renvoient HTTP 400 dès l’envoi.Valeurs :
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive (par défaut). Alias : aspect_ratio. Les tâches avec images de début/fin, d’édition et d’extension exigent adaptive.Secondes entières
4–30 ; par défaut 5 pour une requête ordinaire. -1 active la durée automatique. Le mode explicite edit accepte uniquement -1 ou l’omission, traitée comme -1 ; la durée suit la vidéo source. La durée automatique réserve 30 secondes, puis le coût est régularisé selon les tokens utilisés.Générer du son,
true par défaut. Alias : audio. Ce réglage de sortie est distinct des références audio audio_urls.auto (par défaut), reference, edit ou extend, uniquement avec des médias de référence. Un type explicite déclenche les contrôles à l’envoi décrits ci-dessous.Tableau d’images, toutes traitées comme
reference_image. Maximum 10 images au total avec image_with_roles. Utilisez ce dernier pour les images de début et de fin.Chaque élément contient
url et role. Rôles : reference_image, first_frame (1 maximum), last_frame (1 maximum, avec une image de début). Maximum 10 images avec image_urls ; évitez les rôles contradictoires. Avec video_urls / audio_urls, les images de début/fin deviennent des images de référence multimodales.Maximum 5 vidéos, de 2–30 secondes chacune, 30 secondes au total. Une vidéo source à éditer doit durer 4–30 secondes.
Maximum 5 extraits audio, de 2–30 secondes chacun, 30 secondes au total. Les références audio seules sont autorisées, sans image ni vidéo.
Avec
true, une image de la dernière frame est renvoyée après réussite dans data.result.videos[].last_frame_url.draft / draft_task_id ne sont pas pris en charge : retirez-les de la requête, sinon HTTP 400 est renvoyé. Utilisez Seedance 2.5 pour le mode brouillon.Exigences des médias
Utilisez des URLhttp(s) accessibles publiquement ou des identifiants asset:// approuvés. La résolution de sortie et les limites de pixels des vidéos d’entrée sont contrôlées séparément.
| Média | Limites |
|---|---|
| Images | ≤10 au total dans les deux champs ; JPEG / PNG / WebP / BMP / TIFF / GIF / HEIC / HEIF ; largeur et hauteur chacune de 300–6000 px ; ratio 0.4–2.5 ; <30 MB chacune. |
| Vidéos | ≤5 ; MP4 / MOV, vidéo H.264 / H.265 et audio AAC / MP3 ; 2–30 secondes chacune, ≤30 secondes au total ; ≤200 MB chacune ; largeur et hauteur de 300–6000 px, ratio 0.4–2.5, largeur × hauteur de 409,600–8,295,044 pixels, 24–60 FPS. |
| Audio | ≤5 ; WAV / MP3 ; 2–30 secondes chacun, ≤30 secondes au total ; ≤15 MB chacun. |
Types de tâches et contraintes
| Mode | Utilisation et contraintes |
|---|---|
| Texte vers vidéo | Fournissez prompt sans média de référence ; omettez omni_reference_task_type. |
| Références vers vidéo | Fournissez des références ; reference est facultatif. Les limites normales de durée et de ratio s’appliquent. |
| Images de début/fin | Utilisez image_with_roles ; size / aspect_ratio doit être adaptive. |
| Édition vidéo | edit ; au moins 1 vidéo source de 4–30 secondes ; ratio adaptive, duration à -1 ou omis. |
| Extension vidéo | extend ; au moins 1 vidéo de référence ; ratio adaptive. |
auto, le type est déduit des médias et du prompt, et peut échouer pendant la génération. Même un type explicite peut produire InvalidParameter.TaskTypeMismatch s’il ne correspond pas au prompt.
Exemples de requêtes
Références multimodales
{
"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"
}
Images de début et de fin
{
"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
}
Édition vidéo
{
"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"
}
Extension vidéo
{
"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
}
Ressources privées
Faites approuver les images ou vidéos contenant des visages réels dans la bibliothèque avant d’utiliserasset://. Le champ model de l’import doit aussi être seedance-2-5-flash. Consultez l’API de bibliothèque et utilisez le nom Flash ci-dessous.
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:// dans la liste des ressources, puis utilisez-le dans image_urls, image_with_roles[].url, video_urls ou audio_urls.
État et résultats
Interrogez l’API d’état des tâches.pending / processing : en cours ; completed : réussite ; failed : échec. Lisez data.result.videos[0].url[0] : url est un tableau.
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"
}
]
}
}
}
| Champ | Signification |
|---|---|
data.usage.completion_tokens | Tokens de régularisation finale. Peut être absent pendant quelques secondes après la fin ; interrogez à nouveau. |
data.cost | Montant réellement facturé en USD, après remises du compte. Utilisez la valeur retournée. |
data.credits_cost | Crédits réellement débités. |
data.result.videos[].url | Tableau d’URL vidéo ; téléchargez et sauvegardez rapidement. |
data.result.videos[].last_frame_url | URL de dernière frame, uniquement après réussite avec return_last_frame: true. |
data.error.message | Motif d’échec. En cas d’échec, data.cost vaut 0 et le montant réservé est remboursé. |
Facturation
- À l’envoi, un montant est réservé au tarif par seconde de la résolution. Avec une vidéo de référence, le palier avec entrée additionne durée de sortie et durée totale des vidéos de référence.
- Sans
duration, une requête ordinaire réserve 5 secondes de sortie.duration: -1, oueditsans durée, réserve 30 secondes de sortie. - Après réussite :
data.usage.completion_tokens÷ 1,000,000 × tarif applicable par million de tokens, puis remises du compte. La différence est remboursée ou débitée. La présence d’une référence vidéo détermine le paliertokenoutoken-input. Le montant final estdata.cost. - Un envoi rejeté n’est pas facturé pour la génération. Une génération échouée rembourse le montant réservé. Voir la page des tarifs.
Erreurs courantes
| Situation | Action |
|---|---|
| HTTP 400 : résolution non prise en charge | Utilisez 480p / 720p, pas 1080p. |
| HTTP 400 : trop de références | Maximum 10 images au total, 5 vidéos et 5 extraits audio ; vérifiez aussi les durées. |
| HTTP 400 : brouillon non pris en charge | Retirez draft / draft_task_id. |
| HTTP 400 : type, durée ou ratio | Vérifiez omni_reference_task_type, duration, size / aspect_ratio. |
HTTP 400 : nsfw_content_detected | Traitez comme un refus de modération ; lisez error.message et modifiez le contenu. |
| Modèle introuvable | Utilisez seedance-2-5-flash, pas seedance-2.5-flash. |
Tâche failed | Lisez data.error.message et adaptez médias et prompt au type de tâche. Le montant réservé est remboursé. |