Guides Imọlẹ
Parcours68 / 70
Modèle · Vidéo

Imole Video

Créez des vidéos depuis un texte, des images ou des références. 4 à 15 secondes, 480p ou 768p, avec 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

Créez des vidéos depuis un texte, des images ou des références. 4 à 15 secondes, 480p ou 768p, avec 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 avec son à partir de texte, images ou références.
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

    Texte

    Écrivez pour l’oreille : phrases courtes, ponctuation naturelle et prononciation explicite si nécessaire.

  2. 02

    Interprète

    Choisissez une voix dans la liste et la langue du texte.

  3. 03

    Interprétation

    Sélectionnez Naturel ou un style proposé pour la voix. Le champ Texte contient uniquement les mots à prononcer.

  4. 04

    Sortie

    Choisissez MP3 pour partager, WAV pour monter ou Opus pour compresser.

Exemple 1

Un plan de présentation

Une lanterne sur une table, mouvement lent de caméra, lumière du soir, ambiance calme.

Le fichier et les réglages définissent le résultat attendu.

Réglages

Contrôles disponibles dans Imọlẹ

Tarif

10 cauris / s en 480p · 30 en 768p

Suivi

La génération continue en arrière-plan. Retrouvez le résultat dans votre historique.

API

Intégrer le modèle dans un projet

MéthodePOST
Chemin/videos
URL de basehttps://api.imole.app/v1
Coût API10 cauris / s en 480p · 30 en 768p
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

Identifiant public.

imole-video
promptRequis

Décrivez la scène, les mouvements et les sons.

—
mode

Déduit des fichiers fournis ; texte sans fichier. Une combinaison incompatible est refusée.

text, image, reference
duration

Durée entière demandée, 5 par défaut.

4–15
resolution

768p par défaut.

480p, 768p
aspect_ratio

16:9 par défaut ; auto possible en mode image.

21:9, 16:9, 4:3, 1:1, 3:4, 9:16, auto
first_frame / last_frame

En mode image : first_frame seul impose le départ, last_frame seul impose la fin ; fournis les deux pour relier deux images de mêmes dimensions. Fichier encodé en base64, data URL, URL HTTPS ou objet {base64, filename, content_type}. 25 Mo maximum.

—
references

En mode référence : 9 images, 3 vidéos et 3 audios maximum, avec 12 fichiers au total. Chaque vidéo/audio dure 2–15 secondes ; 15 secondes cumulées maximum pour les vidéos, et 15 pour les audios. Numérotation indépendante dans le prompt : <Picture 1>, <Video 1>, <Audio 1>. Fichier encodé en base64, data URL, URL HTTPS ou objet {base64, filename, content_type}. 25 Mo maximum.

—
seed

Entier positif facultatif.

—
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.

Créer le média

curl -X POST "https://api.imole.app/v1/videos" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-video",
  "prompt": "Une lanterne solaire sur une table, mouvement lent, ambiance calme.",
  "mode": "text",
  "duration": 5,
  "resolution": "480p"
}'

Suivre le traitement

curl -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/media/jobs/{jobId}"

Télécharger le résultat

curl -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/media/jobs/{jobId}/content"
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 cauris / s en 480p · 30 en 768p

Le coût exact dépend du modèle et, pour certains médias, de la durée, de la résolution ou de la qualité.

Documentation de référenceContrats Imole Video, Video 3D et Upscaling