Modèle · Vidéo

Imole Perspective

Imole Perspective transforme une image en séquence animée avec profondeur, parallaxe contrôlée et mouvement de caméra.

Identifiant du modèleimole-3d-video

Route API POST /videos

Présentation du modèle

Ce que fait ce modèle

Imole Perspective transforme une image forte en mouvement de caméra avec profondeur. L’image constitue l’instruction ; les commandes de caméra façonnent le résultat.

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

Révélations produit, portraits, architecture, affiches et paysages avec séparation nette premier plan/arrière-plan.
Ajout de parallaxe et mouvement de caméra sans réécrire le contenu visuel.

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.

01
Image source
Utilisez un JPG, PNG ou WebP net avec une silhouette lisible et plusieurs plans de profondeur.
02
Mouvement de caméra
Choisissez cercle, zoom, travelling, orbital, horizontal ou vertical selon la géométrie de la scène.
03
Intensité
Commencez au milieu. Augmentez seulement si l’image possède assez d’espace autour du sujet.
04
Durée
Utilisez des clips courts pour les révélations subtiles et plus longs pour les grands mouvements.

Exemple 1

Bonne direction source

Utilisez une image produit paysage avec l’objet centré, un sol visible, un arrière-plan séparé et des marges généreuses. Sélectionnez un mouvement orbital lent, une intensité moyenne et 6 secondes.

Perspective n’a pas besoin d’une instruction de scène écrite ; la composition source et les commandes de mouvement portent l’intention.

Réglages

Contrôles disponibles dans Imọlẹ

Mouvement

Faites correspondre l’axe à l’image : horizontal pour les scènes larges, vertical pour les sujets hauts, orbital pour les objets centrés.

Intensité

Utilisez 0,1–0,4 pour un réalisme subtil et des valeurs supérieures uniquement pour une profondeur stylisée.

API

Intégrer le modèle dans un projet

MéthodePOST

Chemin/videos

URL de basehttps://api.imole.app/v1

Coût API10 cauris / vidéo

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-3d-video.

—

image_url

URL d’une image source JPG, PNG ou WebP. Requise si image_base64 est absent.

—

image_base64

Image source en Base64. Requise si image_url est absent.

—

duration

Durée en secondes. Valeur par défaut : 5.

1-15

fps

Images par seconde. Valeur par défaut : 30.

—

animation_type

Mouvement de caméra prédéfini. Valeur par défaut : circle.

circle, zoom, dolly, orbital, horizontal, vertical

intensity

Intensité de profondeur et de parallaxe. Valeur par défaut : 0,5.

0.1-1.0

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.

Animation circulaire

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_url": "https://imole.app/docs-samples/poster.png",
  "duration": 5,
  "fps": 30,
  "animation_type": "circle",
  "intensity": 0.45
}'

Animation avec zoom

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_url": "https://imole.app/docs-samples/poster.png",
  "duration": 5,
  "fps": 30,
  "animation_type": "zoom",
  "intensity": 0.35
}'

Vérifier l’état de la tâche

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-3d-video.mp4

Production

Réponse, suivi et erreurs

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

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

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 / vidéo

Imole Perspective coûte 10 cauris par vidéo, quelle que soit la durée.

Documentation de référenceContrat du service Imole Perspective et commandes du Laboratoire