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-lite-image",
    "prompt": "赛博朋克风格的城市夜景，霓虹灯闪烁",
    "size": "16:9",
    "resolution": "1K",
    "n": 1
  }'

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

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-lite-image",
    "prompt": "赛博朋克风格的城市夜景，霓虹灯闪烁",
    "size": "16:9",
    "resolution": "1K",
    "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-lite-image"
requis
Nom du modèle de génération d’imagesRenseignez toujours ce nom de modèle : gemini-3.1-flash-lite-image (Nano Banana Lite)
Ce modèle se connecte directement au canal officiel Gemini, n’a pas de variante -official et ne prend pas en charge le paramètre de repli official_fallback.
​
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
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 :
  • 1K — ~1024px, résolution standard (Lite ne prend en charge que ce niveau)
Lite ne prend en charge que la 1K. Les valeurs 2K / 4K / 0.5K sont silencieusement rétrogradées en 1K, sans erreur et sans réellement produire une haute résolution. L’interface utilisateur front-end n’a pas besoin d’exposer d’option de résolution.
​
n
integer
défaut:"1"
Nombre d’images à générerPlage : 1 ~ 4, par défaut 1Lorsque n>1, le back-end envoie plusieurs requêtes simultanées à la source en amont et facture selon le nombre réel d’images générées avec succès. Il est recommandé que le front-end envoie toujours 1 (affichage de la progression image par image, facturation plus intuitive).⚠️ Note : Doit être un nombre brut (par exemple 1), sans guillemets, sinon une erreur sera renvoyée
​
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
​
webhook
string
Adresse de rappel de la tâche (base)En cas de succès / échec de la tâche, la plateforme appelle webhook + /callback (sans transmettre à la source en amont). Fournir ce paramètre réduit considérablement le polling ; il reste toutefois recommandé de conserver le polling comme solution de repli.
Points clés d’utilisation de Lite
  • Ne prend pas en charge google_search / google_image_search : Lite utilise le point de terminaison interactions de la Developer API, la source en amont n’a pas activé l’outil Search (renvoie “Search as tool is not enabled for this model”), et l’adaptateur de la plateforme ne transmet pas ce paramètre. Le fournir ne provoque pas d’erreur et l’image est générée normalement, mais sans aucun effet d’amélioration par la recherche. Pour une amélioration par la recherche, utilisez plutôt gemini-3.1-flash-image-preview.
  • Ne prend pas en charge la retouche locale via mask_url (la série Gemini utilise le ratio d’aspect + images de référence, et non les masques).
  • Facturation basée sur les tokens (à la différence du prix fixe par image de flash/pro) : entrée environ 0,25 /milliondetokens,sortied′imageenviron30/million de tokens, sortie d'image environ 30 /million de tokens, une image 1K ≈ 1120 tokens de sortie ≈ 0,0336 $/image. Le prix réel dépend de la configuration du multiplicateur dans le back-office.
  • Toutes les images générées contiennent le filigrane invisible SynthID de Google (comportement en amont, impossible à désactiver).

​
Response

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