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": "gpt-image-1-official",
    "prompt": "An ancient castle under a starry sky",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

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

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": "gpt-image-1-official",
    "prompt": "An ancient castle under a starry sky",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

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

​
Modèles pris en charge

ModèleDescriptionModesImage-vers-imageMax d’imagesFacturation
gpt-image-1-officialPriorité à la stabilité, adapté à la génération d’images généraleTexte-vers-image / Image-vers-imagePris en charge4Size × Quality
gpt-image-1.5-officialNouvelle version, adaptée à une qualité supérieure et à l’édition complexeTexte-vers-image / Image-vers-imagePris en charge4Size × Quality

​
Autorisations

​
Authorization
string
requis
Toutes les requêtes 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 ce qui suit aux en-têtes de votre requête :
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
requis
Nom du modèle
  • gpt-image-1-official — Priorité à la stabilité, adapté à la génération d’images générale
  • gpt-image-1.5-official — Nouvelle version, adaptée à une qualité supérieure et à l’édition complexe
​
prompt
string
requis
Description textuelle pour la génération d’images, prend en charge à la fois le chinois et l’anglais
​
size
string
défaut:"1:1"
Ratio d’aspectRatios pris en charge :
  • 1:1 — Carré (par défaut)
  • 3:2 — Paysage
  • 2:3 — Portrait
​
n
integer
défaut:"1"
Nombre d’images à générerPlage : 1-4
  • Les valeurs ≤ 0 seront traitées comme 1
  • Les valeurs > 4 seront traitées comme 4
Avertissement : Doit être un nombre brut (par exemple 1), sans guillemets, sinon une erreur sera renvoyée
​
quality
string
défaut:"auto"
Qualité de l’image
  • auto — Sélection automatique de la qualité (par défaut)
  • low — Plus rapide, plus économique
  • medium — Équilibre entre qualité et coût
  • high — Qualité supérieure, coût plus élevé
​
background
string
défaut:"auto"
Mode d’arrière-plan
  • auto — Arrière-plan automatique (par défaut)
  • opaque — Arrière-plan opaque
  • transparent — Arrière-plan transparent, recommandé avec le format de sortie png
background: transparent ne peut pas être utilisé simultanément avec output_format: jpeg
​
moderation
string
défaut:"auto"
Niveau de modération
  • auto — Niveau de modération par défaut
  • low — Modération plus permissive
​
output_format
string
défaut:"png"
Format de sortie
  • png — Format par défaut, adapté aux arrière-plans transparents
  • jpeg — Taille de fichier plus petite, adapté à la sortie d’images générale
background: transparent ne peut pas être utilisé simultanément avec output_format: jpeg
​
output_compression
integer
Niveau de compression de sortie, plage 0-100
  • Recommandé uniquement pour jpeg
  • Non recommandé pour png
​
image_urls
array
Tableau d’URL d’images de référence, active le mode image-vers-image lorsqu’il est fourniLimite : Jusqu’à 15 images de référence
​
mask_url
string
URL de l’image de masque pour l’inpainting
  • Doit être utilisé conjointement avec image_urls
  • Sera soumis via l’API d’édition officielle
  1. Avant de téléverser l’image de masque, veuillez confirmer que le canal Alpha de l’image est « Oui ».
  2. La taille de l’image de masque doit correspondre à la première image de référence.

​
Référence des tailles

Les ratios d’aspect sont utilisés en externe ; le système les associe automatiquement aux dimensions officielles en interne.
RatioTaille effectiveDescription
1:11024x1024Carré
2:31024x1536Portrait
3:21536x1024Paysage

​
Exemples d’utilisation

Texte-vers-image (minimal) 
{
  "model": "gpt-image-1-official",
  "prompt": "An ancient castle under a starry sky"
}
Texte-vers-image (paramètres complets) 
{
  "model": "gpt-image-1-official",
  "prompt": "A flat icon of a glass bottle with no background",
  "size": "2:3",
  "quality": "high",
  "background": "transparent",
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
Image-vers-image (référence unique) 
{
  "model": "gpt-image-1.5-official",
  "prompt": "Convert the reference image to illustration style, preserving the main outline",
  "size": "1:1",
  "quality": "auto",
  "image_urls": [
    "https://your-cdn.com/input.png"
  ],
  "n": 1
}
Image-vers-image (fusion multi-références) 
{
  "model": "gpt-image-1.5-official",
  "prompt": "Merge two reference images into an illustration poster, preserving the main outlines",
  "size": "1:1",
  "quality": "auto",
  "background": "transparent",
  "image_urls": [
    "https://your-cdn.com/input-a.png",
    "https://your-cdn.com/input-b.png"
  ],
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
Plusieurs images (n > 1) 
{
  "model": "gpt-image-1-official",
  "prompt": "Four minimalist poster variations of a red fox",
  "size": "1:1",
  "quality": "low",
  "output_format": "png",
  "n": 4
}

​
Response

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

​
Notes

  1. Traitement asynchrone : Après soumission, un task_id est renvoyé. Interrogez /v1/tasks/{task_id} pour obtenir les résultats
  2. Sélection du modèle : Utilisez gpt-image-1-official pour la génération d’images générale ; utilisez gpt-image-1.5-official pour l’édition de haute qualité et les tâches image-vers-image complexes
  3. Exigences relatives aux URL d’images : Pour image-vers-image, utilisez des URL d’images publiquement accessibles et stables
  4. Facturation : Facturé pour chaque image générée avec succès ; aucun frais en cas d’échec