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.7-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "Replace the background with a snowy mountain scene",
    "resolution": "1080P"
  }'

{
  "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.7-videoedit",
    "video_urls": ["https://cdn.example.com/original.mp4"],
    "prompt": "Replace the background with a snowy mountain scene",
    "resolution": "1080P"
  }'

{
  "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.7-videoedit
​
video_urls
array<string>
requis
Tableau d’URLs de vidéos sources à éditer
Seule la 1re vidéo est utilisée
Contraintes vidéo :
  • Format : mp4, mov
  • Durée : 2–10s
  • Résolution : largeur et hauteur dans la plage [240, 4096] pixels
  • Rapport d’aspect : 1:8 – 8:1
  • Taille de fichier : jusqu’à 100 Mo
​
prompt
string
Instruction d’édition décrivant les changements souhaités, jusqu’à 5000 caractères
Si omise, le modèle effectue un transfert de style par défaut
Exemple : "Change the character's outfit to a red gown", "Replace the background with a snowy mountain scene"
​
negative_prompt
string
Prompt négatif décrivant le contenu indésirable, jusqu’à 500 caractères
​
image_urls
array<string>
Tableau d’URLs d’images de référence, jusqu’à 4 imagesUtilisé pour spécifier le style ou l’apparence cible (par exemple, style de référence pour le transfert de style)
​
resolution
string
défaut:"1080P"
Résolution de la vidéo de sortieOptions :
  • 720P — standard
  • 1080P — haute définition (par défaut)
​
duration
integer
défaut:"0"
Durée de la vidéo de sortie (secondes)
  • 0 (par défaut) : conserver la durée complète de la vidéo d’origine
  • Entier entre 2-10 : prendre la durée spécifiée à partir du début
Lorsque duration=0, la facturation est basée sur la durée réelle de la vidéo de sortieLa durée spécifiée ne peut pas dépasser la durée de la vidéo d’origine dans video_urls
​
size
string
Rapport d’aspect de sortieFormats pris en charge :
  • 16:9 — écran large paysage
  • 9:16 — portrait
  • 1:1 — carré
  • 4:3 — paysage
  • 3:4 — portrait
Si omis, le rapport d’aspect correspond à celui de la vidéo d’entrée
​
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
​
watermark
boolean
défaut:"false"
Ajouter un filigrane « AI Generated » à la vidéo générée
  • true : ajouter un filigrane
  • false : sans filigrane (par défaut)
​
seed
integer
Entier servant de graine pour contrôler le caractère aléatoire du contenu généréPlage de valeurs : entier ≥ 0
  • Pour des requêtes identiques, le modèle génère des résultats différents lorsqu’il reçoit des valeurs de graine différentes (par exemple, omettre la graine)
  • Pour des requêtes identiques, le modèle génère des résultats similaires lorsqu’il reçoit la même valeur de graine, mais une cohérence exacte n’est pas garantie
​
metadata
object
Objet de paramètres supplémentaires

​
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 : Édition vidéo de base (le plus simple)

{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "prompt": "Replace the background with a snowy mountain scene"
}

​
Cas 2 : Transfert de style (avec image de référence)

{
  "model": "wan2.7-videoedit",
  "prompt": "Transfer the video style to the anime style of the reference image",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": [
    "https://cdn.example.com/anime_style.jpg"
  ],
  "resolution": "1080P",
  "watermark": false
}

​
Cas 3 : Conserver l’audio original de la vidéo

Adapté aux vidéos avec son de fond ou dialogues importants : 
{
  "model": "wan2.7-videoedit",
  "video_urls": ["https://cdn.example.com/speech.mp4"],
  "prompt": "Replace the background with a mountain path",
  "metadata": { "audio_setting": "origin" }
}

​
Cas 4 : Paramètres complets

{
  "model": "wan2.7-videoedit",
  "prompt": "Change the character's outfit to a red gown",
  "negative_prompt": "blurry, distorted",
  "video_urls": ["https://cdn.example.com/original.mp4"],
  "image_urls": ["https://cdn.example.com/reference.jpg"],
  "resolution": "1080P",
  "duration": 0,
  "size": "16:9",
  "prompt_extend": true,
  "watermark": false,
  "seed": 888,
  "metadata": {
    "audio_setting": "origin"
  }
}

​
Traitement audio

audio_settingDescriptionScénarios appropriés
auto (par défaut)L’IA regénère un audio adapté en fonction du contenu vidéo éditéChangements majeurs de style visuel où l’audio doit être mis à jour en conséquence
originForcer la conservation de la piste audio originale de la vidéoVidéos avec musique de fond ou dialogues importants
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.