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": "gemini-omni-flash-preview",
    "prompt": "a red apple on a wooden table, short cinematic clip",
    "aspect_ratio": "16:9"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-omni-flash-preview",
    "prompt": "a red apple on a wooden table, short cinematic clip",
    "aspect_ratio": "16:9"
  }'

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

​
Authentification

​
Authorization
string
requis
Toutes les requêtes nécessitent une authentification par Bearer Token.Obtenir une clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé API.Ajoutez l’en-tête suivant lors de l’envoi des requêtes :
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é à gemini-omni-flash-preview.
​
prompt
string
requis
Instruction textuelle. Pour le Text-to-Video, il s’agit de la description de la scène ; pour l’Image/Video-to-Video, il s’agit de l’instruction de mouvement / style / édition.
prompt et les éléments de référence (image_urls / video_urls) : fournissez au moins l’un des deux.
​
image_urls
array<string>
Images de référence, 16 au maximum. Chaque élément est une URL http(s)://.Prend en charge JPEG / PNG. Pour plusieurs sujets (par exemple « chat + pelote de laine »), vous pouvez transmettre plusieurs images et décrire dans le prompt la manière dont elles interagissent.
​
video_urls
array<string>
Vidéo de référence / à éditer, 1 au maximum (les références multi-vidéos ne sont pas prises en charge). Il peut s’agir d’un lien direct http(s):// ou de data:video/....
La vidéo de référence dure de 1 à 24 secondes ; recommandation officielle : ≤3 secondes.
​
aspect_ratio
string
défaut:"16:9"
Format d’image de la vidéo, qui contrôle réellement l’orientation de la sortie.Prend uniquement en charge :
  • 16:9 - paysage (par défaut)
  • 9:16 - portrait
Les autres valeurs sont traitées comme 16:9.
​
resolution
string
défaut:"720p"
Résolution de la vidéo. Actuellement, seul 720p est pris en charge.
​
extend_from_task_id
string
Identifiant de la tâche précédente : indiquez le ** task_id** de la tâche de génération précédente.

​
Réponse

​
code
integer
Code de statut de la réponse. En cas de succès, il vaut 200.
​
data
array
Tableau de tâches renvoyé.

​
Interroger le résultat de la tâche

La génération vidéo est une tâche asynchrone. Après la soumission, un task_id est renvoyé ; utilisez le point de terminaison Obtenir le statut de la tâche pour interroger la progression et le résultat de la génération.

​
Exemple de résultat réussi

{
  "code": 200,
  "data": {
    "id": "task_01KS1H7ZYSJWH1N779S2FSHTKA",
    "status": "completed",
    "progress": 100,
    "created": 1779246294,
    "completed": 1779246334,
    "actual_time": 40,
    "estimated_time": 60,
    "cost": 1.0,
    "credits_cost": 10,
    "result": {
      "videos": [
        {
          "url": ["https://cdn.example.com/gemini_omni_xxx.mp4"],
          "expires_at": 1779332760
        }
      ]
    }
  }
}

​
Cas d’usage

​
Scénario 1 : Text-to-Video

{
  "model": "gemini-omni-flash-preview",
  "prompt": "a blue butterfly landing on a flower, macro, soft light",
  "aspect_ratio": "9:16"
}

​
Scénario 2 : Image-to-Video

{
  "model": "gemini-omni-flash-preview",
  "prompt": "turn this drawing into realistic footage, use it only as a motion guide",
  "image_urls": ["https://example.com/sketch.jpg"]
}

​
Scénario 3 : Video-to-Video

{
  "model": "gemini-omni-flash-preview",
  "prompt": "when the person touches the mirror, make it ripple like liquid",
  "video_urls": ["https://example.com/clip.mp4"]
}