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-pro",
    "prompt": "A cat playing piano, camera slowly zooms in",
    "duration": 8,
    "resolution": "1080p",
    "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-pro",
    "prompt": "A cat playing piano, camera slowly zooms in",
    "duration": 8,
    "resolution": "1080p",
    "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-pro — Vidu Q3 Pro
  • viduq3-turbo — Vidu Q3 Turbo
​
prompt
string
requis
Prompt textuel, 2000 caractères maximumObligatoire pour le text-to-video. Optionnel pour l’image-to-video et le mode « première et dernière image ».Exemple : "A cat playing piano, camera slowly zooms in"
​
duration
integer
défaut:"5"
Durée de la vidéo (en secondes)Plage : 1 à 16Par défaut : 5
​
resolution
string
défaut:"720p"
Résolution de la vidéoOptions :
  • 540p — définition standard
  • 720p — HD (par défaut)
  • 1080p — Full HD
Par défaut : 720p
​
aspect_ratio
string
Format d’image de la vidéo (uniquement en mode text-to-video)Options :
  • 16:9 — paysage
  • 9:16 — portrait
  • 4:3 — traditionnel
  • 3:4 — portrait traditionnel
  • 1:1 — carré
Ce paramètre n’est disponible qu’en mode text-to-video (lorsque image_urls n’est pas fourni).
​
image_urls
array<url>
Tableau d’URL d’images pour la génération image-to-videoLe système détermine automatiquement le mode de génération en fonction du nombre d’images :
  • 0 image (non fourni) : mode text-to-video
  • 1 image : mode image-to-video (l’image est utilisée comme image de départ)
  • 2 images : mode « première et dernière image » (première image = image de début, seconde image = image de fin)
Exemple : ["https://example.com/photo.jpg"]
  • 2 images maximum prises en charge
  • Pour le mode « première et dernière image », exactement 2 images doivent être fournies
  • Lorsque image_urls est fourni (1 ou 2 images), le paramètre aspect_ratio ne peut pas être utilisé — le format d’image est automatiquement déterminé par l’image
​
audio
boolean
défaut:"true"
Générer ou non l’audio (dialogues, effets sonores)Par défaut : trueDéfinissez sur false si vous avez besoin d’une vidéo silencieuse.
​
seed
integer
Graine entière pour contrôler le caractère aléatoire du contenu généréPlage : entier entre -1 et 2^32-1
  • Pour la même requête, des valeurs de graine différentes (y compris non spécifiée ou -1, qui utilise un nombre aléatoire) produiront des résultats différents
  • Pour la même requête, la même valeur de graine produira des résultats similaires, mais une reproductibilité exacte n’est pas garantie

​
Routage automatique

Le système détermine automatiquement le mode de génération en fonction du nombre d’images dans image_urls :
Nombre d’imagesModeDescription
0 (non fourni)Text-to-VideoGénération uniquement à partir de la description textuelle
1Image-to-VideoUtilise l’image comme image de départ
2Première et dernière imagePremière image = image de début, seconde image = image de fin

​
Matrice de prise en charge des paramètres

ParamètreText-to-VideoImage-to-VideoPremière et dernière image
model✅ Obligatoire✅ Obligatoire✅ Obligatoire
prompt✅ ObligatoireOptionnelOptionnel
image_urls-✅ 1 image✅ 2 images
duration✅ 1 à 16 s✅ 1 à 16 s✅ 1 à 16 s
resolution✅✅✅
aspect_ratio✅--
audio✅✅✅
seed✅✅✅

​
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 : Texte vers vidéo

{
  "model": "viduq3-pro",
  "prompt": "A cat playing piano, camera slowly zooms in",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

​
Cas 2 : Image vers vidéo (image unique)

{
  "model": "viduq3-pro",
  "prompt": "The person slowly turns and smiles",
  "image_urls": ["https://example.com/photo.jpg"],
  "duration": 5,
  "resolution": "720p"
}

​
Cas 3 : Vidéo à partir de la première et de la dernière image

{
  "model": "viduq3-pro",
  "prompt": "The person gradually sits down from standing",
  "image_urls": [
    "https://example.com/first.jpg",
    "https://example.com/last.jpg"
  ],
  "duration": 8
}

​
Cas 4 : Vidéo silencieuse (audio désactivé)

{
  "model": "viduq3-pro",
  "prompt": "Sunset seascape timelapse photography",
  "duration": 10,
  "resolution": "1080p",
  "audio": false
}
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.