Passer au contenu principal
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": "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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

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"
    }
  ]
}

Autorisation

Authorization
string
requis
Tous les points de terminaison de l’API nécessitent une authentification par Bearer TokenObtenez votre API Key :Rendez-vous sur la page de gestion des API Keys pour obtenir votre API KeyAjoutez-la dans l’en-tête de la requête :
Authorization: Bearer YOUR_API_KEY

Paramètres de la requête

model
string
requis
Nom du modèle de génération vidéoModèles pris en charge :
  • doubao-seedance-1-5-pro — version 1.5 Pro, prend en charge la génération audio et la première/dernière image
prompt
string
requis
Description du contenu de la vidéoDécrivez en détail les scènes, les actions et les styles pour obtenir de meilleurs résultatsExemple : "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand"
duration
integer
défaut:"5"
Durée de la vidéo (en secondes)Plage prise en charge : 4 ~ 12 secondesPar défaut : 5
aspect_ratio
string
défaut:"16:9"
Rapport d’aspect de la vidéoOptions :
  • 16:9 — paysage
  • 9:16 — portrait
  • 1:1 — carré
  • 4:3 — rapport traditionnel
  • 3:4 — rapport traditionnel vertical
  • 21:9 — ultra-large
Par défaut : 16:9
resolution
string
défaut:"720p"
Résolution de la vidéoOptions :
  • 480p — définition standard
  • 720p — haute définition
  • 1080p — Full HD
Par défaut : 720p
seed
integer
Entier seed pour contrôler l’aléa du contenu généréPlage de valeurs : entier entre -1 et 2^32-1
  • Pour une même requête, si le modèle reçoit des valeurs de seed différentes (par exemple, en ne précisant pas le seed ou en définissant seed à -1, ce qui utilise un nombre aléatoire), des résultats différents seront générés
  • Pour une même requête, si le modèle reçoit la même valeur de seed, des résultats similaires seront générés, sans garantie qu’ils soient identiques
audio
boolean
défaut:"false"
Générer ou non de l’audioLorsque ce paramètre est true, la vidéo inclut un audio d’accompagnement généré par l’IAPar défaut : false
La génération audio est exclusive à 1.5 Pro ; la version 1.0 ne prend pas en charge ce paramètre
camerafixed
boolean
défaut:"false"
Fixer ou non la caméraLorsque ce paramètre est true, la position de la caméra reste fixePar défaut : false

Combinaisons de résolution et de rapport d’aspect

RésolutionRapports d’aspect pris en chargeRemarques
480p16:9, 4:3, 1:1, 3:4, 9:16, 21:9Tous pris en charge
720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9Tous pris en charge
1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9Tous pris en charge
image_urls
array<url>
Tableau d’URL d’images pour la génération image-vers-vidéoRègles d’attribution automatique des rôles :
  • 1 image = première image
  • 2 images = première image + dernière image
Exemple : ["https://example.com/first.png", "https://example.com/last.png"]
  • image_urls et image_with_roles ne peuvent pas être utilisés ensemble
image_with_roles
array
Tableau d’images avec rôles pour un contrôle plus précisExemple :
[
  {"url": "https://example.com/start.png", "role": "first_frame"},
  {"url": "https://example.com/end.png", "role": "last_frame"}
]
  • image_urls et image_with_roles ne peuvent pas être utilisés ensemble
  • La première et la dernière image ne prennent en charge qu’une seule image chacune

Réponse

code
integer
Code d’état de la réponse, 200 en cas de succès
data
array
Tableau de données de la réponse

Cas d’usage

Cas 1 : texte-vers-vidéo avec audio

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

Cas 2 : courte vidéo verticale haute qualité

{
  "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
}

Cas 3 : vidéo dynamique à partir d’une première image

{
  "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
}

Cas 4 : effet de transition avec première/dernière image

{
  "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
}
Interroger les résultats de la tâcheLa génération vidéo est une tâche asynchrone qui renvoie un task_id lors de la soumission. Utilisez le point de terminaison Obtenir le statut de la tâche pour interroger la progression et les résultats de la génération.

Différences avec la version 1.0

Fonctionnalité1.0 fast/quality1.5 Pro
Résolution par défaut1080p720p
Résolutions prises en charge480p/720p/1080p480p/720p/1080p
Plage de durée2-12 s4-12 s
Génération audioNon prise en chargePrise en charge
Image de référencereference (1 image)Non prise en charge