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": "wan2.6-i2v-flash",
    "prompt": "The person turns around and smiles",
    "image_urls": ["https://example.com/portrait.jpg"],
    "resolution": "1080p",
    "duration": 5
  }'

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

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": "wan2.6-i2v-flash",
    "prompt": "The person turns around and smiles",
    "image_urls": ["https://example.com/portrait.jpg"],
    "resolution": "1080p",
    "duration": 5
  }'

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

​
Authentification

​
Authorization
string
requis
Tous les endpoints requièrent une authentification par Bearer TokenObtenez votre API Key :Visitez la page de gestion des API Keys pour obtenir votre API KeyAjoutez-la à 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éo, fixé à wan2.6-i2v-flash
​
image_urls
array<string>
requis
Tableau d’URLs d’images de référence (1 seule image de première trame prise en charge)Prend en charge les URLs d’images accessibles publiquement ou l’encodage Base64 (data:image/png;base64,...)Exemple : ["https://example.com/image.jpg"]
Exigences relatives à l’image :
  • Format : JPEG, JPG, PNG (sans transparence), BMP, WEBP
  • Résolution : plage largeur/hauteur 240–8000 pixels
  • Taille : ≤ 10 Mo
​
prompt
string
Description du contenu de la vidéoOptionnel mais recommandé pour image-to-video ; décrit les actions et effets attendusSpécifiez clairement le sujet, l’action, la caméra et le style pour de meilleurs résultatsExemple : "The person in the image smiles and waves, camera slowly zooms in"
​
negative_prompt
string
Prompt négatif décrivant le contenu indésirableMaximum 500 caractèresExemple : "blurry, low quality, distorted"
​
resolution
string
défaut:"1080p"
Résolution de la vidéoOptions :
  • 720p — HD
  • 1080p — FHD (par défaut)
Par défaut : 1080p
La résolution influe directement sur le tarif, 1080p est plus cher que 720p. Le rapport d’aspect est déterminé par l’image d’entrée.
​
duration
integer
défaut:"5"
Durée de la vidéo (secondes)Plage prise en charge : 2 à 15 secondes (entier)Par défaut : 5
​
audio
boolean
défaut:"true"
Générer un audioDéfinir à true : génère automatiquement de la musique de fond/des effets sonores adaptés (par défaut)Définir à false : produit une vidéo silencieusePar défaut : true
Non pris en charge lorsque le modèle est wan2.6-i2v.
​
audio_url
string
URL d’audio personnalisé (wav/mp3, 3–30 secondes, ≤ 15 Mo)Priorité inférieure à audio : ignoré lorsque audio=falseSi l’audio est plus long que la durée de la vidéo, il sera tronqué ; s’il est plus court, la partie restante sera silencieuse
Exigences du fichier audio :
  • Format : wav, mp3
  • Durée : 3–30 secondes
  • Taille : ≤ 15 Mo
​
prompt_extend
boolean
défaut:"true"
Activer la réécriture intelligente du promptAméliore significativement les résultats pour les prompts courts, mais augmente le temps de traitementPar défaut : true
​
shot_type
string
Type de plan, nécessite prompt_extend=trueOptions :
  • single — plan unique (par défaut), produit une vidéo continue en un seul plan
  • multi — multi-plans, produit une vidéo narrative avec plusieurs transitions de plans
shot_type a une priorité supérieure à prompt. Même si le prompt mentionne « multi-shot », définir single produira toujours un plan unique.
​
seed
integer
Graine aléatoire (≥ 0), spécifier la même graine permet de reproduire des résultats similairesExemple : 12345
​
watermark
boolean
défaut:"false"
Ajouter un filigrane « AI Generated » (en bas à droite)Par défaut : false

​
Contrôle audio

Combinaison de paramètresRésultat
Pas de audio ni audio_urlAudio généré automatiquement (par défaut)
audio_url: "https://..."Utiliser l’audio spécifié
audio: falseVidéo silencieuse
audio: false + audio_url: "..."Vidéo silencieuse (audio a une priorité supérieure)

​
Réponse

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

​
Cas d’utilisation

​
Cas 1 : Requête minimale

{
  "model": "wan2.6-i2v-flash",
  "image_urls": ["https://example.com/image.jpg"]
}

​
Cas 2 : Paramètres complets

{
  "model": "wan2.6-i2v-flash",
  "prompt": "The person in the image smiles and waves, camera slowly zooms in",
  "image_urls": ["https://example.com/image.jpg"],
  "negative_prompt": "blurry, low quality, distorted",
  "resolution": "1080p",
  "duration": 10,
  "seed": 12345,
  "prompt_extend": true,
  "shot_type": "multi",
  "audio": true,
  "watermark": false
}

​
Cas 3 : Audio personnalisé

{
  "model": "wan2.6-i2v-flash",
  "prompt": "Person dancing to the music",
  "image_urls": ["https://example.com/dancer.jpg"],
  "audio_url": "https://example.com/music.mp3",
  "resolution": "1080p",
  "duration": 10
}

​
Cas 4 : Vidéo silencieuse

{
  "model": "wan2.6-i2v-flash",
  "prompt": "Flower slowly blooming",
  "image_urls": ["https://example.com/flower.jpg"],
  "audio": false,
  "resolution": "720p",
  "duration": 5
}

​
Cas 5 : Modèle d’effet

{
  "model": "wan2.6-i2v-flash",
  "image_urls": ["https://example.com/person.jpg"],
  "template": "flying",
  "resolution": "720p"
}

​
Cas 6 : Image Base64

{
  "model": "wan2.6-i2v-flash",
  "prompt": "Make the cat stand up and walk",
  "image_urls": ["data:image/png;base64,iVBORw0KGgo..."],
  "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 l’endpoint Obtenir le statut de la tâche pour interroger la progression et les résultats de la génération.