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-pro-image-preview",
    "prompt": "A bamboo forest path under moonlight",
    "size": "1:1",
    "n": 1,
    "resolution": "1K"
  }'

{
  "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-pro-image-preview",
    "prompt": "A bamboo forest path under moonlight",
    "size": "1:1",
    "n": 1,
    "resolution": "1K"
  }'

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

​
Autorisations

​
Authorization
string
requis
Toutes les API nécessitent une authentification à l’aide d’un Bearer TokenObtenir la clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIÀ ajouter dans l’en-tête de la requête :
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
défaut:"gemini-3-pro-image-preview"
requis
Nom du modèle de génération d’imagesModèles pris en charge :
  • gemini-3-pro-image-preview — Version standard
  • gemini-3-pro-image-preview-official — Version officielle
Exemple : "gemini-3-pro-image-preview" ou "gemini-3-pro-image-preview-official"
​
prompt
string
requis
Description textuelle pour la génération d’images
​
size
string
Taille de l’image généréeFormats pris en charge :
  • Ratios : auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
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.
​
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
​
resolution
string
Résolution de l’image de sortieValeurs prises en charge :
  • 1K — Résolution 1K (par défaut)
  • 2K — Résolution 2K
  • 4K — Résolution 4K
⚠️ Note : La génération d’images 4K au format base64 nécessite un temps de traitement plus long
​
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-pro-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-image ou l’édition d’images💡 Saisie rapide (zone « Try it ») :
  1. Cliquez sur « + Add an item » pour ajouter une URL d’image
  2. Saisissez l’URL complète de l’image ou les données base64
Limite : Maximum 14 images

​
Response

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