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": "kling-v2-6",
    "prompt": "A golden cat running on a sunlit meadow, slow motion, cinematic quality",
    "mode": "std",
    "duration": 5,
    "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": "kling-v2-6",
    "prompt": "A golden cat running on a sunlit meadow, slow motion, cinematic quality",
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

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

​
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éoModèles pris en charge :
  • kling-v2-6 — Kling v2.6 (recommandé)
​
prompt
string
requis
Prompt textuel, maximum 2500 caractèresDécrivez les scènes, actions et styles en détail pour de meilleurs résultats de générationExemple : "A golden cat running on a sunlit meadow, slow motion, cinematic quality"
​
mode
string
défaut:"std"
Mode de générationOptions :
  • std — mode standard (720P, vidéo silencieuse uniquement)
  • pro — mode professionnel (1080P, prend en charge la génération audio automatique)
Par défaut : std
Limitation du mode standard : le mode std ne prend en charge que les vidéos silencieuses. Le paramètre audio nécessite le mode pro.
​
duration
integer
défaut:"5"
Durée de la vidéo (secondes)Options : 5 ou 10Par 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é
Par défaut : 16:9
​
negative_prompt
string
Prompt négatif pour exclure le contenu indésirableExemple : "blurry, low quality, distorted"
​
image_urls
array<url>
Tableau d’URLs d’images pour la génération image-to-video
  • Transmettre 1 image : utilisée comme première trame
  • Transmettre 2 images : assignées automatiquement comme première trame + dernière trame (nécessite mode: "pro")
Maximum 2 images prises en chargeExemple : ["https://example.com/first.jpg"]
  • Maximum 2 images prises en charge
  • La dernière trame (2 images) nécessite uniquement le mode pro ; le mode std ne prend en charge que la première trame (1 image)
  • La dernière trame et l’audio sont mutuellement exclusifs : en mode pro, la dernière trame (2 images) et l’audio (audio: true) ne peuvent pas être utilisés ensemble
  • En mode image-to-video, aspect_ratio peut être remplacé par le rapport d’aspect réel de l’image
​
audio
boolean
défaut:"false"
Générer automatiquement un audioPar défaut : false
  • Disponible uniquement en mode: "pro"
  • Mutuellement exclusif avec la dernière trame : l’audio ne peut pas être utilisé avec la dernière trame (2 images)
​
watermark
boolean
Ajouter un filigrane

​
Matrice de prise en charge des fonctionnalités

TypeFonctionnalitéstd 5sstd 10spro 5spro 10s
Text-to-VideoGénération✅ (silencieux uniquement)✅ (silencieux uniquement)✅✅
Text-to-VideoAuto-audio--✅✅
Image-to-VideoGénération✅ (silencieux uniquement)✅ (silencieux uniquement)✅✅
Image-to-VideoPremière trame✅✅✅✅
Image-to-VideoDernière trame--✅✅
Image-to-VideoAuto-audio--✅✅
Remarque : en mode pro, le contrôle de la dernière trame et de l’audio sont mutuellement exclusifs et ne peuvent pas être utilisés ensemble.

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

Le système détermine automatiquement le mode selon que image_urls est fourni : sans images signifie text-to-video, avec images signifie image-to-video.
ParamètreText-to-VideoImage-to-Video
prompt✅ Obligatoire✅ Obligatoire
image_urls❌ Non utilisé✅ Obligatoire (1–2 images, dernière trame nécessite pro)
negative_prompt✅ Optionnel✅ Optionnel
mode✅ Optionnel✅ Optionnel
duration✅ Optionnel✅ Optionnel
aspect_ratio✅ Optionnel⚠️ Peut être remplacé par le rapport de l’image
audio✅ Optionnel (nécessite pro)✅ Optionnel (nécessite pro)
watermark✅ Optionnel✅ Optionnel

​
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 (mode standard)

{
  "model": "kling-v2-6",
  "prompt": "A golden cat running on a sunlit meadow, slow motion, cinematic quality",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}

​
Cas 2 : Texte vers vidéo (mode Pro + prompt négatif)

{
  "model": "kling-v2-6",
  "prompt": "Tokyo Shibuya crossing at night, neon lights reflected on wet ground, people walking with umbrellas",
  "negative_prompt": "blurry, low quality, distorted",
  "mode": "pro",
  "duration": 10,
  "aspect_ratio": "16:9"
}

​
Cas 3 : Image vers vidéo (première trame)

{
  "model": "kling-v2-6",
  "prompt": "The person in the frame turns and smiles",
  "image_urls": ["https://example.com/portrait.jpg"],
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}

​
Cas 4 : Image vers vidéo (contrôle première + dernière trame)

{
  "model": "kling-v2-6",
  "prompt": "City timelapse transitioning from day to night",
  "image_urls": ["https://example.com/day-city.jpg", "https://example.com/night-city.jpg"],
  "mode": "pro",
  "duration": 5
}

​
Cas 5 : Mode Pro + audio automatique

{
  "model": "kling-v2-6",
  "prompt": "Waves crashing against rocks, seagulls circling in the sky, lighthouse in the distance",
  "mode": "pro",
  "duration": 10,
  "audio": true,
  "aspect_ratio": "16:9"
}
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.