curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast-official",
    "prompt": "a golden retriever running on the beach, sunset, cinematic",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

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

VEO3

Génération vidéo officielle VEO3

Mode de traitement asynchrone, renvoie un identifiant de tâche pour les requêtes ultérieures
Prend en charge texte-vers-vidéo et image-vers-vidéo (contrôle de la première image / première & dernière image)
Prend en charge les résolutions 720P et 1080P
Prend en charge les durées vidéo de 4/6/8 secondes
Prend en charge la génération d’une piste audio
Prend en charge le contrôle de la politique de génération de personnes

POST

videos

generations

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast-official",
    "prompt": "a golden retriever running on the beach, sunset, cinematic",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast-official",
    "prompt": "a golden retriever running on the beach, sunset, cinematic",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

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

Autorisation

Authorization

string

requis

Tous les points de terminaison de l’API nécessitent une authentification par Bearer TokenObtenez votre API Key :Rendez-vous sur la page de gestion des API Keys pour obtenir votre API KeyAjoutez-la dans 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 disponibles :

veo3.1-fast-official — Veo 3.1 Official Fast
veo3.1-quality-official — Veo 3.1 Official High Quality

prompt

string

requis

Prompt textuel positifDécrivez en détail les scènes, les actions, les styles, etc. pour de meilleurs résultats. Les prompts en anglais sont recommandés.Exemple : "a golden retriever running on the beach, sunset, cinematic"

negative_prompt

string

Prompt négatif pour exclure le contenu indésirableExemple : "blurry, low quality, watermark, text"

duration

integer

défaut:"8"

Durée de la vidéo en secondesValeurs recommandées : 4 / 6 / 8Par défaut : 8Remarque : doit être un nombre pur (par ex. 8), n’ajoutez pas de guillemets, sinon une erreur se produira

aspect_ratio

string

défaut:"16:9"

Rapport d’aspect de la vidéoValeurs disponibles :

16:9 — paysage
9:16 — portrait

Par défaut : 16:9

resolution

string

défaut:"720p"

Résolution de la vidéoValeurs disponibles :

720p — résolution standard
1080p — haute définition
4K — ultra haute définition

Par défaut : 720p

first_frame_image

string

URL de l’image de la première image pour la génération image-vers-vidéo

L’URL de l’image doit être accessible publiquement, sans protection anti-hotlink
Il est recommandé d’utiliser des URL de stockage d’objets plutôt que des liens de téléchargement temporaires

last_frame_image

string

URL de l’image de la dernière image pour la génération image-vers-vidéoUtilisée avec first_frame_image pour contrôler la première et la dernière image

seed

integer

Seed aléatoire pour reproduire les résultats de générationPlage de valeurs : 0 — 4294967295

sample_count

integer

défaut:"1"

Nombre d’échantillons à générer (1-4), il est actuellement recommandé d’utiliser 1Par défaut : 1

generate_audio

boolean

défaut:"false"

Générer ou non une piste audio

person_generation

string

défaut:"allow_adult"

Politique de génération de personnesValeurs disponibles :

allow_adult — n’autoriser que la génération de personnes/visages adultes
disallow — ne pas autoriser la génération de personnes ou de visages

Par défaut : allow_adult

resize_mode

string

défaut:"pad"

Stratégie de redimensionnement de l’image (effective pour image-vers-vidéo)Valeurs disponibles :

pad — mode de remplissage
crop — mode de recadrage

Par défaut : pad

enhance_prompt

boolean

défaut:"true"

Activer ou non l’amélioration du prompt en amontPar défaut : true

Ce paramètre ne peut être défini que sur true. Le définir sur false provoquera une erreur de requête
Si vous n’avez pas besoin de ce paramètre, ne l’incluez pas

Texte-vers-vidéo vs image-vers-vidéo

Le système détermine automatiquement le mode selon que des paramètres d’image sont fournis ou non : sans image pour texte-vers-vidéo, avec image pour image-vers-vidéo.

Paramètre	Texte-vers-vidéo	Image-vers-vidéo
`prompt`	Obligatoire	Obligatoire
`first_frame_image`	Non utilisé	Obligatoire (au moins une)
`last_frame_image`	Non utilisé	Facultatif (dernière image)
`negative_prompt`	Facultatif	Facultatif
`duration`	Facultatif	Facultatif
`aspect_ratio`	Facultatif	Facultatif
`resolution`	Facultatif	Facultatif
`seed`	Facultatif	Facultatif
`generate_audio`	Facultatif	Facultatif
`person_generation`	Facultatif	Facultatif
`resize_mode`	Non applicable	Facultatif
`enhance_prompt`	Facultatif	Facultatif

Réponse

code

integer

Code d’état de la réponse, 200 en cas de succès

data

array

Tableau de données de la réponse

Afficher Propriétés

status

string

Statut de la tâche, initialement submitted après soumission

task_id

string

Identifiant unique de la tâche pour interroger son statut et ses résultats

Scénarios d’utilisation

Scénario 1 : texte-vers-vidéo (basique)

{
  "model": "veo3.1-fast-official",
  "prompt": "a golden retriever running on the beach, sunset, cinematic"
}

Scénario 2 : texte-vers-vidéo (paramètres complets)

{
  "model": "veo3.1-quality-official",
  "prompt": "a cinematic close-up of a ragdoll cat slowly walking through a sunlit living room",
  "negative_prompt": "blurry, low quality, watermark, text",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "seed": 12345,
  "generate_audio": true,
  "person_generation": "disallow",
  "enhance_prompt": true
}

Scénario 3 : image-vers-vidéo (une seule première image)

{
  "model": "veo3.1-fast-official",
  "prompt": "the cat slowly walks forward and looks around",
  "first_frame_image": "https://example.com/cat.png",
  "duration": 8,
  "resolution": "720p"
}

Scénario 4 : image-vers-vidéo (première image + dernière image)

{
  "model": "veo3.1-quality-official",
  "prompt": "smooth cinematic transition from the first frame to the last frame",
  "first_frame_image": "https://example.com/frame-start.png",
  "last_frame_image": "https://example.com/frame-end.png",
  "duration": 8,
  "resolution": "1080p"
}

Scénario 5 : vidéo avec audio

{
  "model": "veo3.1-quality-official",
  "prompt": "a busy coffee shop with people chatting and barista making latte art",
  "duration": 8,
  "generate_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 le point de terminaison Obtenir le statut de la tâche pour interroger la progression et les résultats de la génération.

Remix vidéo VEO3 Génération vidéo MiniMax-Hailuo-02

Documentation Index

​Autorisation

​Paramètres de la requête

​Texte-vers-vidéo vs image-vers-vidéo

​Réponse

​Scénarios d’utilisation

​Scénario 1 : texte-vers-vidéo (basique)

​Scénario 2 : texte-vers-vidéo (paramètres complets)

​Scénario 3 : image-vers-vidéo (une seule première image)

​Scénario 4 : image-vers-vidéo (première image + dernière image)

​Scénario 5 : vidéo avec audio

Autorisation

Paramètres de la requête

Texte-vers-vidéo vs image-vers-vidéo

Réponse

Scénarios d’utilisation

Scénario 1 : texte-vers-vidéo (basique)

Scénario 2 : texte-vers-vidéo (paramètres complets)

Scénario 3 : image-vers-vidéo (une seule première image)

Scénario 4 : image-vers-vidéo (première image + dernière image)

Scénario 5 : vidéo avec audio