Guides Imọlẹ Parcours87 / 88
Modèle · Vidéo

Imole Video

Imole Video crée une vidéo avec audio synchronisé à partir d’un texte, d’images de début et de fin, ou de références image, vidéo et audio.

Identifiant du modèleimole-video
Route API POST /videos
Tester dans le Laboratoire
Présentation du modèle

Ce que fait ce modèle

Imole Video crée des clips avec audio synchronisé depuis un texte, une ou deux images délimitant le plan, ou des références image, vidéo et audio.

Cette page rassemble la description du modèle, les réglages exposés par Imọlẹ et les informations nécessaires pour l’appeler avec l’API.

Capacités

Résultats et opérations pris en charge

  • Clips sociaux, scènes produit, transitions guidées et créations audiovisuelles appuyées par plusieurs références.
  • Plans de 4 à 15 secondes dans les ratios courants, du 21:9 au 9:16.
Demande

Décrire clairement le résultat attendu

Construisez la demande dans cet ordre. Chaque étape précise une information que le modèle peut utiliser directement.

  1. 01

    Scène et sujet

    Décrivez le lieu du plan et ce qui doit rester visuellement cohérent.

  2. 02

    Action dans le temps

    Écrivez une action observable et, pour les clips longs, divisez-la en étapes temporelles.

  3. 03

    Caméra

    Choisissez la taille du plan, l’angle, la focale, le mouvement, la vitesse et si la caméra doit rester fixe.

  4. 04

    Lumière et mouvement

    Décrivez l’éclairage, l’atmosphère, le mouvement principal, les mouvements secondaires et leur intensité.

  5. 05

    Contraintes

    Indiquez dans le prompt les sous-titres, logos, défauts visuels, coupes, tremblements et changements d’identité à éviter.

Exemple 1

Plan cinématographique unique

Style documentaire cinématographique. À l’aube dans une rue calme de Cotonou, un jeune coursier fixe un petit colis solaire au porte-bagages puis démarre. Commencer sur un plan rapproché des mains, puis un travelling arrière lent révèle la rue pendant que le vélo avance. Soleil chaud et bas, légère poussière, mouvement réaliste des vêtements et roues, rythme naturel, aucune coupe, aucun sous-titre, aucun logo, aucune caméra tremblante.

Le plan possède une action, une caméra, un mouvement physique, une lumière, un rythme et des contraintes négatives.

Exemple 2

Clip minuté

[0–3 s] Macro sur des gouttes de pluie sur un scooter électrique vert foncé. [3–6 s] La caméra recule pendant que le phare s’allume. [6–8 s] Orbite lente trois quarts tandis que le scooter reste immobile. Studio de nuit, sol mouillé réfléchissant, palette vert profond et ambre, trajectoire continue, aucun texte, personne, aucune déformation.

Les étapes minutées facilitent la mise en scène d’un plan cohérent sans ajouter de scènes sans rapport.

Réglages

Contrôles disponibles dans Imọlẹ

Type de création

Choisissez t2va pour le texte, fl2va avec une première image, une dernière image ou les deux, ou ref2va pour des références image, vidéo et audio.

Durée

Choisissez entre 4 et 8 secondes et utilisez la durée la plus courte contenant toute l’action.

Ratio

Utilisez Automatique ou choisissez 21:9, 16:9, 4:3, 1:1, 3:4 ou 9:16 selon la destination finale.

Graine

Réutilisez la même graine facultative lorsque vous souhaitez une variation plus stable.

Références

Pour ref2va, ajoutez seulement les images, vidéos et fichiers audio qui doivent réellement guider le résultat.

API

Intégrer le modèle dans un projet

MéthodePOST
Chemin/videos
URL de basehttps://api.imole.app/v1
Coût API10 à 20 cauris / seconde
AuthorizationBearer $IMOLE_API_KEY
Content-TypeUtilisez application/json pour les requêtes JSON.

Chargez IMOLE_API_KEY depuis une variable d’environnement côté serveur. N’insérez jamais la clé dans le code envoyé au navigateur, une application mobile, un dépôt Git ou un fichier partagé.

Corps de requête

Paramètres acceptés

ParamètreDescriptionValeurs
modelRequis

Utilisez imole-video.

promptRequis

Décrivez la scène, l’action, le mouvement, la caméra, l’audio et les contraintes du clip à générer.

taskRequis

Type de création vidéo.

t2va, fl2va, ref2va
duration_secondsRequis

Durée demandée en secondes.

4-8
aspect_ratio

Ratio de la vidéo générée.

auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
seed

Graine facultative pour stabiliser une nouvelle génération.

first_frame

Première image facultative pour la tâche fl2va. Fournissez first_frame, last_frame ou les deux.

last_frame

Dernière image facultative pour la tâche fl2va. Fournissez first_frame, last_frame ou les deux.

conditions

Jusqu’à 10 objets de référence image, vidéo ou audio pour la tâche ref2va. Chaque élément indique son type, son rôle de référence et une URL ou une valeur data.

Code

Exemples d’intégration

Testez d’abord la requête cURL, puis reprenez le même identifiant de modèle dans votre application JavaScript ou Python.

Texte vers vidéo

curl -X POST "https://api.imole.app/v1/videos" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-video",
  "task": "t2va",
  "prompt": "[Supported models]\nimole-video.\n\n[Style]\nCinematic startup launch short film, premium commercial realism, soft film grain, warm sunrise contrast, shallow depth of field.\n\n[Scene]\nA quiet design studio at sunrise, large windows, long wooden table, laptop, notebooks, floating dust in the light.\n\n[Character]\nA focused founder in a textured dark jacket, calm but excited, natural breathing, consistent face and outfit.\n\n[Shot Details]\n[00:00-00:03] Slow push-in from a medium wide shot as the founder opens the laptop and sunrise light crosses the keyboard.\n[00:03-00:06] Close three-quarter profile, the founder studies a rising graph and forms a restrained smile.\n[00:06-00:08] Over-shoulder finish with a tiny camera arc, screen glow reflected on the face, room depth visible.\n\n[Camera]\nSlow dolly in, gentle micro-handheld stabilization, restrained motion.\n\n[Exclusions]\nAvoid subtitles, watermark, broken anatomy, unreadable UI text, logo distortion, whip pans.",
  "duration_seconds": 6,
  "aspect_ratio": "16:9",
  "seed": 42
}'

Première et dernière images

curl -X POST "https://api.imole.app/v1/videos" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-video",
  "task": "fl2va",
  "prompt": "[Supported models]\nimole-video.\n\n[Style]\nPolished product motion plate, photoreal, premium SaaS campaign feel, clean light transitions, controlled depth.\n\n[Scene]\nUse the provided source image as the first frame and preserve its composition, product layout, and overall mood.\n\n[Shot Details]\n[00:00-00:02] Keep the composition anchored to the source image and add a gentle forward push with layered parallax between foreground and background.\n[00:02-00:04] Introduce a subtle light roll across the desk edge and screen border while preserving the exact subject placement.\n[00:04-00:05] Finish with a calm settling motion, soft lens breathing,.\n\n[Positive Constraints]\nPreserve subject identity.\n\n[Exclusions]\nAvoid add extra text, warp objects, change the original palette dramatically, abrupt morphing.",
  "duration_seconds": 4,
  "aspect_ratio": "auto",
  "first_frame": {
    "url": "https://imole.app/docs-samples/poster.png"
  },
  "last_frame": {
    "url": "https://imole.app/docs-samples/poster.png"
  }
}'

Références vers vidéo

curl -X POST "https://api.imole.app/v1/videos" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-video",
  "task": "ref2va",
  "prompt": "[Supported models]\nimole-video.\n\n[Style]\nPolished product motion plate, photoreal, premium SaaS campaign feel, clean light transitions, controlled depth.\n\n[Scene]\nUse the provided source image as the first frame and preserve its composition, product layout, and overall mood.\n\n[Shot Details]\n[00:00-00:02] Keep the composition anchored to the source image and add a gentle forward push with layered parallax between foreground and background.\n[00:02-00:04] Introduce a subtle light roll across the desk edge and screen border while preserving the exact subject placement.\n[00:04-00:05] Finish with a calm settling motion, soft lens breathing,.\n\n[Positive Constraints]\nPreserve subject identity.\n\n[Exclusions]\nAvoid add extra text, warp objects, change the original palette dramatically, abrupt morphing.",
  "duration_seconds": 5,
  "aspect_ratio": "1:1",
  "seed": 42,
  "conditions": [
    {
      "type": "image",
      "role": "reference",
      "url": "https://imole.app/docs-samples/poster.png"
    },
    {
      "type": "audio",
      "role": "reference",
      "url": "https://imole.app/docs-samples/reference.mp3"
    }
  ]
}'

Vérifier l’état

curl -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/videos/$VIDEO_ID"

Télécharger le résultat

curl -L -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/videos/$VIDEO_ID/content" -o imole-video.mp4
Production

Réponse, suivi et erreurs

1

La création renvoie un identifiant de tâche.

2

Interrogez son état jusqu’à `completed` ou `failed`.

3

Téléchargez le résultat seulement après la fin de la tâche.

400

Requête incorrecte : corrigez le champ indiqué avant de réessayer.

401

Clé absente, incorrecte ou révoquée.

402

Solde de cauris insuffisant.

429

Capacité temporairement indisponible : respectez `Retry-After` et utilisez un délai progressif.

5xx

Erreur temporaire : conservez l’identifiant de requête et évitez de relancer deux fois une opération facturable.

Cauris

Tarification et sources

Coût affiché10 à 20 cauris / seconde

Imole Video coûte 10 cauris par seconde générée en 480p et 20 en 768p.

Documentation de référenceContrat du service Imole Video et bibliothèque commune de prompts structurés