Guides Imọlẹ
Parcours65 / 70
Modèle · Image

Imole Image

Créez une image du HD au Full HD, en mode Fast ou Avancé, avec quatre qualités et un fond transparent en PNG. Aperçu automatique inclus.

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

Créez ou transformez des visuels depuis une description et vos images de référence, du HD au Full HD.

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

  • Photographie produit
  • Affiches et illustrations
  • Images avec un fond transparent en PNG
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

Photo produit

Une lanterne solaire noire mate sur un socle indigo, lumière chaude, texture nette, ombres naturelles, composition carrée, aucun texte.

Le sujet, le cadrage, la lumière et les exclusions sont explicites.

Réglages

Contrôles disponibles dans Imọlẹ

Qualité

Moyenne, Haute, Très haute, Maximum

Résolution

HD, Full HD — le tarif dépend aussi de la qualité

Fond

Transparent exige le format PNG

API

Intégrer le modèle dans un projet

MéthodePOST
Chemin/images/generations
URL de basehttps://api.imole.app/v1
Coût APIHD 20/50/150/300 · Full HD 30/70/200/450 cauris (Moyenne/Haute/Très haute/Maximum)
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
images

Références pour POST /images/edits : 1 à 16 objets { image_url: "data:image/png;base64,…" }. PNG, JPEG ou WebP, 20 Mo au total. URLs distantes non acceptées. Alternative multipart : un fichier par champ image[]. Même tarif que la génération.

—
modelRequis

Identifiant public.

imole-image
promptRequis

Décrivez le sujet, le style, la composition et les détails attendus.

—
image_mode

Mode de génération, Fast par défaut. Même tarif pour les deux modes.

fast, advanced
quality

Qualité, medium par défaut.

medium, high, xhigh, max
resolution

Palier de résolution, hd par défaut. Fixe le prix avec la qualité.

hd, full_hd
orientation

Orientation, square par défaut.

square, landscape, portrait
size

Alternative aux préréglages : largeurxhauteur, multiples de 16, ratio maximal 3:1 et 2 359 296 pixels (Full HD). Le prix suit le palier de pixels.

—
background

Fond, auto par défaut. transparent exige PNG.

auto, opaque, transparent
output_format

Format de sortie, png par défaut.

png, jpeg
output_compression

Compression JPEG uniquement, entier de 0 à 100.

0–100
stream

Transport SSE si true ; JSON final par défaut. L’aperçu est inclus automatiquement. Une seule image par requête.

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

Image · HD Moyenne · 10 cauris

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.",
  "image_mode": "fast",
  "quality": "medium",
  "resolution": "hd",
  "orientation": "square",
  "output_format": "png"
}'

Créer depuis une référence · HD Moyenne · 10 cauris — remplacez le base64 par votre image

curl -X POST "https://api.imole.app/v1/images/edits" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-image",
  "prompt": "Conserve exactement la forme de l’objet de référence. Remplace le fond par un studio bleu clair.",
  "image_mode": "fast",
  "quality": "medium",
  "resolution": "hd",
  "orientation": "square",
  "output_format": "png",
  "images": [
    {
      "image_url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAusB9Wl6vnEAAAAASUVORK5CYII="
    }
  ]
}'

PNG transparent · Full HD Haute · 35 cauris

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": "Une lanterne solaire noire, isolée sur fond transparent.",
  "image_mode": "advanced",
  "quality": "high",
  "resolution": "full_hd",
  "orientation": "square",
  "output_format": "png",
  "background": "transparent"
}'
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éHD 20/50/150/300 · Full HD 30/70/200/450 cauris (Moyenne/Haute/Très haute/Maximum)

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