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": "qwen-image-2.0",
    "prompt": "A cute orange cat napping in the sunshine"
  }'

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

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": "qwen-image-2.0",
    "prompt": "A cute orange cat napping in the sunshine"
  }'

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

​
Modèles pris en charge

ModèleDescriptionImages maxTarification
qwen-image-2.0Version standard, qualité et performance équilibrées6Prix fixe
qwen-image-2.0-proVersion Pro, rendu de texte plus puissant, textures réalistes plus raffinées6Prix fixe

​
Autorisations

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

​
Body

​
model
string
requis
Nom du modèle
  • qwen-image-2.0 — version standard, qualité et performance équilibrées
  • qwen-image-2.0-pro — version Pro, rendu de texte plus puissant, textures réalistes plus raffinées
​
prompt
string
requis
Description textuelle pour la génération d’images, jusqu’à 800 caractères
​
size
string
défaut:"1:1"
Rapport d’aspect de l’imageRapports pris en charge :
  • 1:1 — Carré (par défaut)
  • 4:3 — Paysage 4:3
  • 3:4 — Portrait 3:4
  • 16:9 — Paysage écran large
  • 9:16 — Portrait vertical
  • 3:2 — Paysage 3:2
  • 2:3 — Portrait 2:3
​
resolution
string
défaut:"1K"
Niveau de résolution
  • 1K — résolution standard (par défaut)
  • 2K — résolution haute définition
​
n
integer
défaut:"1"
Nombre d’images à générerPlage : 1–6
​
negative_prompt
string
Prompt négatif (contenu que vous ne voulez pas voir apparaître), jusqu’à 500 caractères
​
image_urls
array
Tableau d’URL d’images de référence (mode image-vers-image)Limitations :
  • Doivent être des URL publiquement accessibles
  • Le format Base64 n’est pas pris en charge

​
Tableau de référence des résolutions

La taille de sortie est contrôlée par la combinaison size (rapport) + resolution (niveau de résolution).
RapportNiveau 1KNiveau 2K
1:11024×10242048×2048
4:31152×8642048×1536
3:4864×11521536×2048
16:91280×7202048×1152
9:16720×12801152×2048
3:21248×8322048×1360
2:3832×12481360×2048
  • Uniquement size → niveau 1K par défaut : {"size": "16:9"} → 1280×720
  • size + resolution → niveau spécifié : {"size": "16:9", "resolution": "2K"} → 2048×1152

​
Exemples d’utilisation

Texte-vers-image (requête minimale) 
{
  "model": "qwen-image-2.0",
  "prompt": "A cute orange cat napping in the sunshine"
}
Spécifier rapport et nombre 
{
  "model": "qwen-image-2.0-pro",
  "prompt": "Cyberpunk-style futuristic city nightscape with flickering neon lights",
  "size": "16:9",
  "n": 4
}
Niveau 2K haute définition 
{
  "model": "qwen-image-2.0-pro",
  "prompt": "Exquisite food photography, sushi platter",
  "size": "4:3",
  "resolution": "2K",
  "n": 2
}
Image-vers-image (image de référence + description textuelle) 
{
  "model": "qwen-image-2.0",
  "prompt": "Change the background to a seaside sunset",
  "image_urls": ["https://example.com/my-photo.jpg"]
}

​
Response

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

​
Remarques

  1. Traitement asynchrone : après la soumission, un task_id est retourné. Interrogez /v1/tasks/{task_id} pour obtenir les résultats
  2. Stockage des images : les images générées sont mises en miroir sur le CDN de la plateforme et sont valides à long terme
  3. Règles de facturation : facturé par image générée avec succès, aucun frais en cas d’échec
  4. Exigences relatives aux URL d’images : les images d’entrée doivent être des URL publiquement accessibles, base64 n’est pas pris en charge