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

Imole Video 3D

Animez la profondeur d’une image en un clip de 5 secondes, avec six mouvements et une intensité réglable.

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

Ce que fait ce modèle

Animez la profondeur d’une image en un clip de 5 secondes, avec six mouvements et une intensité réglable.

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

  • Photos animées avec un effet de profondeur.
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

Animer une photo

Importez un paysage et choisissez le mouvement circulaire, intensité 0,5.

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

Réglages

Contrôles disponibles dans Imọlẹ

Tarif

5 cauris / vidéo de 5 secondes

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 API5 cauris / vidéo de 5 secondes
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-3d-video
imageRequis

Fichier encodé en base64, data URL, URL HTTPS ou objet {base64, filename, content_type}. 25 Mo maximum.

—
movement

circle par défaut.

circle, zoom, dolly, orbital, horizontal, vertical
intensity

Amplitude du mouvement, 0,5 par défaut.

0.1–1
duration / fps

Fixés à 5 secondes et 30 images/s.

—
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-3d-video",
  "image": "https://imole.app/docs-samples/media.png",
  "movement": "zoom",
  "intensity": 0.5
}'

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é5 cauris / vidéo de 5 secondes

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