Seedance 2.5 Flash — Créer une vidéo (format natif)

Créez une tâche vidéo Seedance 2.5 Flash au format natif. La soumission renvoie un ID de tâche.

POST/api/v3/contents/generations/tasks

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez Bearer your-api-key dans le Header Authorization.

Emplacement: header

Corps de requête

application/json

Paramètres de génération vidéo Seedance 2.5 Flash. Renseignez le contenu et les rôles selon le mode d’entrée choisi.

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

ID du modèle de génération vidéo. Le Model ID de Seedance 2.5 Flash est doubao-seedance-2-5-flash-261115 ; l’Endpoint ID correspondant peut également être utilisé.

content*array<|||||>

Entrées texte, images, vidéos ou audio. Les références sont limitées à 10 images, 5 vidéos et 5 extraits audio. Chaque vidéo ou extrait audio dure de 2 à 30 secondes, avec un total maximal de 30 secondes par type de média. Les vidéos de référence pour le montage durent de 4 à 30 secondes. Les références audio seules sont prises en charge.

Pour une première image seule, omettez role ou utilisez first_frame. Pour première/dernière image, fournissez deux images marquées first_frame et last_frame. Chaque média de référence exige le rôle reference_* correspondant. Ces trois modes ne se combinent pas. Une dernière image de proportions différentes est recadrée selon la première.

Images et audio : URL publique, URI Base64 ou asset://ASSET_ID ; vidéos : URL publique ou ID de média. Corps limité à 64 MB ; privilégiez les URL pour les gros fichiers. Référencez les médias avec @image1, @video1, @audio1.

Éléments1 <= items

draft?false

Le mode Draft n’est pas pris en charge. Omettez ce champ ou définissez-le sur false ; ne transmettez pas true.

Valeur par défautfalse

Valeurs autorisées

false

omni_reference_task_type?string

Type de tâche multimodale : auto pour la détection automatique, reference pour la génération à partir de références, edit avec vidéo de référence, ratio=adaptive et duration=-1, extend avec vidéo de référence et ratio=adaptive. Un type explicite permet une validation anticipée ; une divergence avec le type détecté peut néanmoins entraîner un échec asynchrone.

Valeur par défaut"auto"

Valeurs autorisées

"auto"
"reference"
"edit"
"extend"

generate_audio?boolean

Indique si un son synchronisé est généré. true produit voix, effets sonores et musique selon le prompt et le contenu visuel ; false produit une vidéo muette. Le son généré est stéréo, quel que soit le nombre de canaux audio en entrée.

Valeur par défauttrue

ratio?string

Format de l’image vidéo. La génération à partir de texte ou de références multimodales accepte un format spécifié ou adaptive ; les tâches à image initiale, à images initiale et finale, de modification et de prolongement vidéo acceptent uniquement adaptive.

Valeur par défaut"adaptive"

Valeurs autorisées

"16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive"

duration?|integer

Durée de génération, en secondes. Accepte de 4 à 30, ou -1 pour laisser le modèle déterminer la durée. Les tâches de modification vidéo acceptent uniquement -1 ; le prolongement vidéo accepte de 4 à 30 ou -1.

Valeur par défaut-1

resolution?string

Résolution vidéo de sortie. Valeurs prises en charge : 480p et 720p. Les dimensions réelles en pixels dépendent de la résolution et du format d’image.

Valeur par défaut"720p"

Valeurs autorisées

"480p"
"720p"

output_format?string

Format de la vidéo de sortie. mp4 convient au web et à la diffusion courante ; mov utilise H.264, YUV444P et PCM et convient à la postproduction, notamment à l’étalonnage, au détourage et à la composition.

Valeur par défaut"mp4"

Valeurs autorisées

"mp4"
"mov"

watermark?boolean

Filigrane « Généré par IA » en bas à droite : true l’ajoute, false l’omet.

Valeur par défautfalse

seed?integer

Graine aléatoire, de -1 à 4294967295. Une même graine peut améliorer la reproductibilité, sans garantir des résultats strictement identiques.

Plage-1 <= value <= 4294967295

return_last_frame?boolean

Renvoyer la dernière image. Avec true, content.last_frame_url fournit un JPEG sans filigrane, aux dimensions de la vidéo, utilisable pour une génération continue. false l’omet.

Valeur par défautfalse

callback_url?string

URL recevant les notifications POST lors d’un changement d’état ; la structure correspond à la réponse de consultation native. Sinon, utilisez l’interrogation périodique.

États notifiés : queued, running, succeeded, failed, expired. Les notifications de succès ou d’échec sont réessayées trois fois sans confirmation de réception réussie sous 5 secondes.

Formaturi

safety_identifier?string

Identifiant utilisateur final sous forme de chaîne en anglais, stable et unique pour un même utilisateur, limité à 64 caractères. Préférez le hachage du nom, de l’ID ou de l’adresse e-mail aux données personnelles.

Longueur1 <= length <= 64

execution_expires_after?integer

Durée de validité de la tâche depuis sa création, en secondes. Une tâche non terminée après ce délai passe à l’état expiré.

Formatint32

Plage3600 <= value <= 259200

Valeur par défaut172800

tools?array<>

Configurer la recherche en ligne. Le modèle décide selon le prompt ; les informations peuvent être plus récentes, avec une latence accrue. Nombre effectif dans usage.tool_usage.web_search ; 0 signifie aucune recherche.

service_tier?string

Niveau de service. Seedance 2.5 Flash prend uniquement en charge l’inférence en ligne default, pas flex. La priorité de file se règle avec priority.

Valeur par défaut"default"

priority?integer

Priorité de file pour un même point de terminaison d’inférence, de 0 à 9. Une valeur élevée est prioritaire ; à priorité égale, l’ordre d’envoi s’applique. Les tâches en cours ne sont pas interrompues.

Plage0 <= value <= 9

Valeur par défaut0

[key: string]?any

Corps de réponse

`application/json`

curl -X POST "https://api.agtcloud.cn/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "generate_audio": true,
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 11,
    "content": [
      {
        "type": "text",
        "text": "La caméra traverse lentement une vallée dans la brume matinale. Le soleil éclaire la forêt, accompagné de doux sons naturels."
      }
    ]
  }'

{
  "id": "TASK_ID"
}

Obtenir le résultat généré

Utilisez l’ID renvoyé avec l’API de consultation pour vérifier l’état et obtenir la vidéo. Pour utiliser des ID de ressources, importez d’abord les ressources via téléverser une ressource.

Documentation officielle Volcengine Ark : créer une tâche de génération vidéoConsultez la définition du protocole amont et les dernières évolutions des champs.

Seedance 2.5 Flash — Créer une vidéo (format natif)

Authentification

Corps de requête

Corps de réponse

200application/json

400application/json

401application/json

429

Obtenir le résultat généré

`application/json`

`application/json`

`application/json`