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": "viduq3",
    "prompt": "Santa Claus and the bear hug by the lakeside",
    "image_urls": [
      "https://example.com/santa.png",
      "https://example.com/bear.png"
    ],
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

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

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": "viduq3",
    "prompt": "Santa Claus and the bear hug by the lakeside",
    "image_urls": [
      "https://example.com/santa.png",
      "https://example.com/bear.png"
    ],
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

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

​
Autorisation

​
Authorization
string
requis
Tous les points de terminaison API nécessitent une authentification par Bearer TokenObtenir votre clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIAjoutez-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éoModèles pris en charge :
  • viduq3-mix — qualité premium, transitions intelligentes renforcées, prend en charge les vidéos courtes de 1 seconde
  • viduq3 — choix par défaut, changement de plan plus intelligent
Comment choisir : utilisez viduq3 pour un usage quotidien ; utilisez viduq3-mix pour une qualité premium ou des effets de mouvement de 1 à 2 secondes.
​
prompt
string
requis
Prompt textuel, 5000 caractères maximumDécrivez les actions et les mouvements de caméra, et non l’apparence (celle-ci est déterminée par les images de référence).Exemple : "Santa Claus and the bear hug by the lakeside"
​
image_urls
array<url>
requis
Tableau d’URL d’images de référence, 1 à 7 imagesPrend en charge les URL d’images publiquement accessibles (http:// ou https://)Exemple : ["https://example.com/santa.png", "https://example.com/bear.png"]
  • Quantité : 1 à 7 images
  • Formats pris en charge : PNG, JPEG, JPG, WebP
  • Taille minimale : 128×128
  • Format d’image : entre 1:4 et 4:1
  • Taille maximale du fichier : ≤ 50 Mo par image
  • Doivent être des URL publiquement accessibles
​
duration
integer
défaut:"5"
Durée de la vidéo (en secondes)
  • viduq3-mix : 1 à 16
  • viduq3 : 3 à 16
Par défaut : 5
viduq3 prend en charge un minimum de 3 secondes, viduq3-mix un minimum de 1 seconde. Veuillez fournir une durée valide selon le modèle choisi.
​
resolution
string
défaut:"720p"
Résolution de la vidéo
  • viduq3-mix : 720p (par défaut) / 1080p
  • viduq3 : 540p / 720p (par défaut) / 1080p
viduq3-mix ne prend pas en charge 540p, veuillez utiliser 720p ou 1080p.
​
aspect_ratio
string
défaut:"16:9"
Format d’image de la vidéoOptions :
  • 16:9 — paysage (par défaut)
  • 9:16 — portrait
  • 4:3 — traditionnel
  • 3:4 — portrait traditionnel
  • 1:1 — carré
​
seed
integer
Graine aléatoire pour contrôler le caractère aléatoire de la générationSi elle n’est pas fournie, une graine aléatoire sera utilisée.
L’utilisation de la même graine avec des paramètres identiques produira des résultats similaires, sans garantie d’être exactement identiques.

​
Comparaison des modèles

Caractéristiqueviduq3viduq3-mix
Recommandé pourUsage quotidien, changement de plans multi-anglesQualité premium, effets de mouvement de 1 à 2 secondes
Plage de durée3 à 16 secondes1 à 16 secondes
Résolution540p / 720p / 1080p720p / 1080p
Images de référence1 à 7 images1 à 7 images

​
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’usage

​
Cas 1 : génération vidéo par référence de base avec viduq3

{
  "model": "viduq3",
  "prompt": "Santa Claus and the bear hug by the lakeside",
  "image_urls": [
    "https://example.com/santa.png",
    "https://example.com/bear.png"
  ]
}

​
Cas 2 : génération vidéo par référence haute qualité avec viduq3-mix

{
  "model": "viduq3-mix",
  "prompt": "A cyberpunk neon street with the cat from reference image walking by",
  "image_urls": [
    "https://example.com/cat-1.png",
    "https://example.com/cat-2.png",
    "https://example.com/cat-3.png"
  ],
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "seed": 42
}
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.