Passer au contenu principal
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "Cyberpunk cityscape at night with neon lights",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "Cyberpunk cityscape at night with neon lights",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

​
Autorisations

​
Authorization
string
requis
Tous les points de terminaison de l’API nécessitent une authentification Bearer TokenObtenir votre clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIAjoutez-la à l’en-tête de la requête :
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
défaut:"gemini-3.1-flash-image-preview"
requis
Nom du modèle de génération d’imagesModèles pris en charge :
  • gemini-3.1-flash-image-preview — Version standard
  • gemini-3.1-flash-image-preview-official — Version officielle
Exemple : "gemini-3.1-flash-image-preview" ou "gemini-3.1-flash-image-preview-official"
​
prompt
string
requis
Description textuelle pour la génération d’images
​
size
string
Ratio d’aspect de l’imageRatios pris en charge :
  • auto — Choix automatique du ratio d’aspect
  • 1:1 — Carré, avatars, réseaux sociaux
  • 3:2 / 2:3 — Photos standard
  • 4:3 / 3:4 — Ratio d’affichage traditionnel
  • 16:9 / 9:16 — Écran large / couvertures vidéo verticales
  • 5:4 / 4:5 — Images Instagram
  • 21:9 — Bannière ultra-large
  • 1:4 / 4:1 — Long poster / bannière
  • 1:8 / 8:1 — Images extrêmement longues / publicités bannière
Pour la génération texte-vers-image, lorsque size vaut auto, la valeur par défaut est 1:1 ou 16:9 ; pour la génération image-vers-image, le ratio d’aspect suit la réponse de la source en amont. Nous vous recommandons de spécifier explicitement un ratio d’aspect.
​
resolution
string
défaut:"1K"
Résolution de l’image de sortieValeurs prises en charge :
  • 0.5K — ~512px, aperçu basse résolution
  • 1K — ~1024px, résolution standard (par défaut)
  • 2K — ~2048px, haute résolution
  • 4K — ~4096px, résolution ultra-haute
Note : Les différentes résolutions ont des tarifs différents. La 4K coûte plus cher que la 1K.
​
n
integer
Nombre d’images à générerPlage : 1-4 (minimum 1, maximum 4)Par défaut : 1⚠️ Note : Doit être un nombre brut (par exemple 1), sans guillemets, sinon une erreur sera renvoyée
​
official_fallback
boolean
défaut:"false"
Utiliser ou non le canal officiel en repli
  • false : Ne pas utiliser (par défaut)
  • true : Utiliser le canal officiel
Lors de l’utilisation du canal officiel (gemini-3.1-flash-image-preview-official), ce paramètre ne peut pas être utilisé.
​
image_urls
array
Liste des URL d’images de référence pour la génération image-vers-imageDeux formats sont pris en charge :1. URL d’image complète
  • URL d’image accessible publiquement (http:// ou https://)
  • Exemple : https://example.com/image.jpg
2. Format encodé en Base64
  • Le format Data URI complet doit être utilisé
  • Format : data:image/{format};base64,{base64data}
  • Formats d’image pris en charge : jpeg, png, webp
  • Exemple : data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Note : Le préfixe data:image/jpeg;base64, doit être inclus
Limitations :
  • Maximum 14 images de référence (recommandé : jusqu’à 10 références d’objets + 4 références de personnages)
  • Taille d’une image : ne dépassant pas 10 Mo
  • Formats pris en charge : jpeg, png, webp
​
google_search
boolean
défaut:"false"
Activer l’amélioration via la recherche textuelle Google
  • true : Le modèle recherchera des informations textuelles sur le Web pour aider à la génération d’images, adapté aux scénarios nécessitant des informations réelles
  • false : Désactivé (par défaut)
​
google_image_search
boolean
défaut:"false"
Activer l’amélioration via la recherche d’images Google
  • true : En plus de la recherche textuelle, des images de référence seront également recherchées pour aider à la génération, adapté aux scénarios nécessitant des références visuelles
  • false : Désactivé (par défaut)
Note : Doit être utilisé conjointement avec google_search: true

​
Response

​
code
integer
Code de statut de la réponse
​
data
array
Tableau de données de réponse