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",
    "prompt": "A cute cat running on the grass",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "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",
    "prompt": "A cute cat running on the grass",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

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

​
Autorisation

​
Authorization
string
requis
Tous les endpoints API 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
​
prompt
string
requis
Description du contenu de la vidéoObligatoire en mode text-to-video. Décrivez les scènes, actions et styles en détail pour de meilleurs résultatsExemple : "A cute cat stretching in the sunlight"
​
image_urls
array<url>
Tableau d’URLs d’images de référence (1 seule image prise en charge)Obligatoire en mode image-to-video. Prend en charge les URLs d’images accessibles publiquementExemple : ["https://example.com/image.jpg"]
Le système sélectionne automatiquement le mode text-to-video ou image-to-video selon que image_urls est inclus ou non
​
negative_prompt
string
Prompt négatif décrivant le contenu indésirableExemple : "blurry, low quality, distorted"
​
aspect_ratio
string
défaut:"16:9"
Rapport d’aspect de la vidéoOptions :
  • 16:9 — paysage (par défaut)
  • 9:16 — portrait
  • 1:1 — carré
  • 4:3 — paysage
  • 3:4 — portrait
Par défaut : 16:9
Non pris en charge en mode image-to-video
​
resolution
string
défaut:"720p"
Résolution de la vidéoOptions :
  • 720p — standard (par défaut)
  • 1080p — haute définition
Par défaut : 720p
La résolution 480p n’est pas prise en charge
Facturation à la seconde. Le tarif varie selon la résolution. Consultez le catalogue des modèles pour les tarifs précis
​
duration
integer
défaut:"5"
Durée de la vidéo (secondes)Valeurs prises en charge : uniquement 5, 10, 15 secondesPar défaut : 5
​
seed
integer
Graine aléatoire pour des résultats reproductiblesExemple : 12345
​
prompt_extend
boolean
Étendre automatiquement le promptLorsqu’activé, le système optimise et enrichit automatiquement votre prompt
​
audio
boolean
Ajouter automatiquement un audioLorsqu’activé, le système génère un audio adapté à la vidéo
​
audio_url
string
URL de l’audio spécifiéPrioritaire sur le paramètre audio
La durée de l’audio ne peut pas dépasser la durée de la vidéo. Si l’audio est plus court que la durée de la vidéo, le début de la vidéo aura du son tandis que le reste sera silencieux.
​
shot_type
string
Type de planOptions :
  • single — plan unique
  • multi — plans multiples
​
watermark
boolean
Ajouter un filigrane
​
template
string
Nom du modèle d’effet pour le mode effets spéciaux image-to-video
En mode effets :
  • Une seule image est requise (transmise via image_urls)
  • Aucun prompt n’est nécessaire (le modèle ignore le champ prompt)
Effets généraux :
  • squish — Écrasement & compression
  • rotation — Rotation
  • poke — Coup d’index
  • inflate — Gonflage de ballon
  • dissolve — Dissolution moléculaire
  • melt — Fonte par vague de chaleur
  • icecream — Planète glacée
  • flying — Lévitation magique
Effets pour une personne :
  • carousel — Carrousel du temps
  • singleheart — Love You
  • dance1 — Moment de balancement
  • dance2 — Pas de danse
Pour plus d’effets, consultez la documentation des modèles Alibaba Wanxiang

​
Combinaisons résolution / rapport d’aspect

Rapport d’aspectDescriptionTaille 720pTaille 1080p
16:9Paysage (par défaut)1280×7201920×1080
9:16Portrait720×12801080×1920
1:1Carré960×9601440×1440
4:3Paysage1088×8321632×1248
3:4Portrait832×10881248×1632

​
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 : Texte vers vidéo (requête simple)

{
  "model": "wan2.6",
  "prompt": "A cute cat stretching in the sunlight"
}

​
Cas 2 : Texte vers vidéo (paramètres complets)

{
  "model": "wan2.6",
  "prompt": "A cute cat running on the grass",
  "negative_prompt": "blurry, low quality, distorted",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "seed": 12345,
  "prompt_extend": true,
  "audio": true,
  "shot_type": "single",
  "watermark": false
}

​
Cas 3 : Image vers vidéo

{
  "model": "wan2.6",
  "prompt": "A kitten running on the ground",
  "image_urls": ["https://upload.apimart.ai/f/apimart-models-images/9998233432754770-c059992d-9b01-47d5-810d-ea0502ac9279-image_task_01KD7SSXDBCEWZ869D6PF249ZW_0.png"],
  "resolution": "1080p",
  "duration": 10
}

​
Cas 4 : Image vers vidéo (image Base64)

{
  "model": "wan2.6",
  "prompt": "Make the cat stand up and walk",
  "image_urls": ["data:image/png;base64,iVBORw0KGgo..."],
  "duration": 5
}

​
Description des modes

​
Texte vers vidéo (Text-to-Video)

  • Le paramètre prompt est obligatoire
  • Le paramètre image_urls n’est pas nécessaire

​
Image vers vidéo (Image-to-Video)

  • Le paramètre image_urls est obligatoire (1 seule image prise en charge)
  • Le paramètre prompt est optionnel, sert à décrire les actions attendues
Le système sélectionne automatiquement le mode selon que image_urls est inclus ou non dans la requête
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.