Guides Imọlẹ Parcours67 / 88
Modèle · Image

Imole Image

Création, modification, transfert de style et transfert de tenue avec Imole Image, jusqu’à deux références ordonnées et des sorties HD ou Full HD.

Identifiant du modèleimole-image
Route API POST /images/generations
Tester dans le Laboratoire
Présentation du modèle

Ce que fait ce modèle

Utilisez Imole Image pour créer dans un style précis, modifier une image, transférer un langage visuel ou appliquer une tenue avec des références ordonnées.

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

  • Créations HD ou Full HD avec Automatique, Photoréaliste et quinze autres styles explicites.
  • Modifications d’identité ou de scène avec une ou deux images de référence.
  • Transfert de style avec une ou deux références et transfert de tenue avec exactement deux images ordonnées.
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

    Sujet

    Décrivez le sujet principal, sa pose, ses matériaux, son âge, son expression ou les détails du produit.

  2. 02

    Environnement

    Définissez le lieu, le moment, la météo, l’arrière-plan et les objets secondaires.

  3. 03

    Composition

    Précisez le cadrage, l’angle, le placement du sujet, la sensation de focale et l’espace négatif.

  4. 04

    Lumière et style

    Nommez la direction de lumière, le contraste, la palette, le médium, la texture et la finition.

  5. 05

    Texte et contraintes

    Mettez le texte visible entre guillemets et indiquez les éléments interdits comme logos, objets supplémentaires ou filigranes.

Exemple 1

Création photoréaliste

Photo éditoriale verticale d’un parfum sur du verre fumé, lumière latérale douce, matières réalistes, palette sombre, aucun texte, aucun filigrane.

Le mode Photoréaliste reçoit une description directe du sujet, de la lumière, des matières et des exclusions.

Exemple 2

Modification avec conservation

Remplace le mur gris par un mur studio vert pâle. Conserve la personne, le visage, la pose, les vêtements, le cadrage, la lumière et les ombres de la première image.

Le mode Modifier sépare clairement la transformation de ce qui doit rester identique.

Exemple 3

Transfert de style

Crée une affiche de voyage avec le sujet demandé et reprends la palette, le trait et la texture des images de style, sans copier leur contenu.

Les références définissent le traitement visuel tandis que le prompt définit le nouveau contenu.

Exemple 4

Transfert de tenue

Conserve la personne de la première image, son visage, sa pose et le décor. Applique la tenue de la seconde image avec des plis, proportions et ombres naturels.

Le rôle des deux images est explicite : personne en premier, tenue en second.

Réglages

Contrôles disponibles dans Imọlẹ

Mode

Choisissez Créer, Modifier, Style ou Tenue avant d’ajouter des références.

Style de création

Le mode Créer propose Automatique et tous les styles nommés, dont Photoréaliste.

Images de référence

Modifier et Style utilisent une ou deux images. Tenue exige la personne cible en premier et la tenue source en second.

Orientation

Avec des références et l’orientation Automatique, la première image détermine le ratio de sortie.

Résolution

Utilisez HD pendant l’exploration et Full HD après validation de la direction.

API

Intégrer le modèle dans un projet

MéthodePOST
Chemin/images/generations
URL de basehttps://api.imole.app/v1
Coût API5 cauris
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-image.

imole-image
promptRequis

Instruction visuelle directe décrivant le résultat à créer ou la modification à appliquer.

—
workflowRequis

Mode exact de création, modification ou transfert de tenue. Consultez les valeurs actuellement disponibles avec GET /images/workflows?model=imole-image.

auto, standard, photoreal, identity_edit, outfit_transfer, strict_prompt, cinematic, retro_anime, watercolor, ink, dot_matrix, kids_drawing, neon_abstract, rainy_window, motion_blur, vintage_tarot, analog_vhs, aesthetic, isometric_3d
images

Images de référence ordonnées. La création n’en utilise aucune ; identity_edit en utilise une ou deux ; outfit_transfer exige exactement deux images, avec la personne cible en premier et la tenue source en second.

—
resolution

Niveau de résolution de sortie.

auto, hd, fullhd
orientation

Orientation du canevas. Avec auto et des références, la première image détermine le ratio.

auto, square, landscape, portrait
seed

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

—
output_format

Format de l’image.

png, jpeg, webp
n

Nombre d’images. Imole Image crée actuellement une image par requête.

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

Modes disponibles

curl -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/images/workflows?model=imole-image"

Création photoréaliste

curl -X POST "https://api.imole.app/v1/images/generations" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-image",
  "prompt": "Photo éditoriale d’un parfum sur du verre fumé, lumière latérale douce.",
  "workflow": "photoreal",
  "resolution": "fullhd",
  "orientation": "portrait",
  "output_format": "webp"
}'

Modification avec une référence

curl -X POST "https://api.imole.app/v1/images/generations" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-image",
  "prompt": "Conserve la personne et remplace le fond par un studio clair.",
  "workflow": "identity_edit",
  "images": [
    {
      "image_url": "https://imole.app/docs-samples/poster.png"
    }
  ],
  "resolution": "hd",
  "orientation": "auto",
  "output_format": "png"
}'

Transfert de tenue — personne puis tenue

curl -X POST "https://api.imole.app/v1/images/generations" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-image",
  "prompt": "Conserve la personne de la première image et applique précisément la tenue de la seconde.",
  "workflow": "outfit_transfer",
  "images": [
    {
      "image_url": "https://imole.app/docs-samples/poster.png?role=target-person"
    },
    {
      "image_url": "https://imole.app/docs-samples/poster.png?role=outfit-source"
    }
  ],
  "resolution": "hd",
  "orientation": "auto",
  "output_format": "jpeg"
}'

Vérifier l’état

curl -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/images/jobs/$IMAGE_ID"

Télécharger le résultat

curl -L -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/images/jobs/$IMAGE_ID/content" -o imole-image.webp
Production

Réponse, suivi et erreurs

La route renvoie un fichier ou un objet JSON selon l’opération. Contrôlez le statut HTTP et le type de contenu avant de stocker la réponse.

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

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érenceContrat API et Laboratoire Imole Image