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": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
  }'

{
  "code": "success",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}

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": "wan2.7-image-pro",
    "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
  }'

{
  "code": "success",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}

​
Autorisations

​
Authorization
string
requis
Toutes les requêtes nécessitent une authentification Bearer Token.Visitez la page de gestion des clés API pour obtenir votre clé API, puis ajoutez-la à l’en-tête de la requête :
Authorization: Bearer YOUR_API_KEY

​
Modèles disponibles

ModèleDescriptionRésolution max (texte-vers-image)Résolution max (édition / séquentielle)Prix
wan2.7-image-proÉdition Professional, meilleurs détails, prend en charge 4K4K2K¥0,50 / image
wan2.7-imageÉdition Standard, génération plus rapide2K2K¥0,20 / image
La facturation est basée sur images générées avec succès × prix unitaire. L’entrée n’est pas facturée. La résolution et le rapport d’aspect n’affectent pas le prix. Les requêtes échouées ne sont pas facturées.

​
Body

​
model
string
requis
Nom du modèle de génération d’images.
  • wan2.7-image-pro — édition Professional, jusqu’à 4K pour le texte-vers-image
  • wan2.7-image — édition Standard, plus rapide, jusqu’à 2K
​
prompt
string
Description textuelle pour la génération d’images, jusqu’à 5000 caractères.
  • Texte-vers-image (sans image_urls) : obligatoire
  • Édition d’image (avec image_urls) : facultatif mais recommandé
Exemple : "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
​
image_urls
array<string>
Tableau d’URL d’images d’entrée pour les scénarios d’édition et de référence multi-images.Fournir ce champ bascule la requête en mode édition d’image.Formats pris en charge : URL HTTP/HTTPS ; data:image/...;base64,... Base64Contraintes : jusqu’à 9 images ; JPEG / PNG / WEBP / BMP ; 240–8000 px, rapport d’aspect 1:8 ~ 8:1 ; ≤ 20 Mo par image
Le rapport d’aspect de sortie correspond automatiquement à la dernière image d’entrée. Le mode édition ne prend en charge que jusqu’à 2K — 4K n’est pas disponible.
​
n
integer
défaut:"1"
Nombre d’images à générer.
  • Mode standard : 1–4 (par défaut 1)
  • Mode séquentiel (enable_sequential: true) : 1–12 (par défaut 1)
Facturé par image générée avec succès. Pré-facturé en fonction de n.
​
size
string
Résolution de sortie ou rapport d’aspect. Prend en charge trois formats :① Mot-clé de résolution (recommandé) : 1K / 2K (par défaut) / 4K (texte-vers-image wan2.7-image-pro uniquement)② Rapport d’aspect : 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 (par défaut niveau 2K)③ Dimensions en pixels : 1024x1024 ou 1024*1024
​
resolution
string
Mot-clé du niveau de résolution : 1K / 2K / 4K. Peut être combiné avec size (rapport d’aspect).
ModèleScénarioNiveaux pris en chargePlage de pixels
wan2.7-image-proTexte-vers-image (non séquentiel)1K / 2K / 4K768×768 ~ 4096×4096
wan2.7-image-proÉdition / séquentielle1K / 2K768×768 ~ 2048×2048
wan2.7-imageTous les scénarios1K / 2K768×768 ~ 2048×2048
​
negative_prompt
string
Prompt négatif décrivant les éléments à éviter. Exemple : "blurry, distorted, low quality"
​
watermark
boolean
défaut:"false"
Indique s’il faut ajouter un filigrane “AI Generated” dans le coin inférieur droit.
​
seed
integer
Graine aléatoire, plage 0–2147483647. La même graine avec des paramètres identiques produit des résultats visuellement cohérents.
​
thinking_mode
boolean
défaut:"true"
Active le mode de raisonnement amélioré pour améliorer la qualité de l’image au prix d’un temps de génération plus long.
Effectif uniquement lorsque le mode séquentiel est désactivé et qu’aucune entrée d’image n’est fournie.
​
enable_sequential
boolean
défaut:"false"
Active le mode de génération séquentielle d’images — génère plusieurs images thématiquement cohérentes en une seule requête. Idéal pour les storyboards et les séries.
  • n maximum est 12 lorsqu’activé
  • thinking_mode et color_palette sont ignorés en mode séquentiel
  • wan2.7-image-pro prend en charge jusqu’à 2K en mode séquentiel (4K non pris en charge)
​
bbox_list
array
Boîtes englobantes pour l’édition interactive — spécifie les zones exactes à éditer ou dans lesquelles insérer du contenu.Structure : [[[x1, y1, x2, y2], ...], ...]
  • La longueur du tableau externe doit être égale à la longueur de image_urls
  • Passez [] pour les images sans boîte englobante
  • Maximum 2 boîtes par image ; les coordonnées sont des valeurs absolues en pixels, origine (0,0) en haut à gauche
Exemple : [[], [[989, 515, 1138, 681]]]
​
color_palette
array<object>
Thème de couleur personnalisé. Mode standard uniquement (pas le mode séquentiel).
  • 3–10 entrées (8 recommandées) ; chaque entrée nécessite hex et ratio
  • La somme de toutes les valeurs de ratio doit être exactement égale à 100.00%
[
  { "hex": "#C2D1E6", "ratio": "23.51%" },
  { "hex": "#636574", "ratio": "76.49%" }
]

​
Response

​
code
string
Statut de la réponse. Retourne "success" en cas de succès.
​
data
array

​
Exemples

​
Texte-vers-image (minimal)

{
  "model": "wan2.7-image-pro",
  "prompt": "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
}

​
Texte-vers-image (avec résolution)

{
  "model": "wan2.7-image-pro",
  "prompt": "Summer beach, blue sky and white clouds, 4K ultra HD",
  "size": "4K",
  "thinking_mode": true
}

​
Texte-vers-image (palette de couleurs personnalisée)

{
  "model": "wan2.7-image-pro",
  "prompt": "Minimalist modern living room",
  "size": "2K",
  "color_palette": [
    { "hex": "#C2D1E6", "ratio": "23.51%" },
    { "hex": "#CDD8E9", "ratio": "20.13%" },
    { "hex": "#B5C8DB", "ratio": "15.88%" },
    { "hex": "#C0B5B4", "ratio": "13.27%" },
    { "hex": "#DAE0EC", "ratio": "10.11%" },
    { "hex": "#636574", "ratio": "8.93%" },
    { "hex": "#CACAD2", "ratio": "5.55%" },
    { "hex": "#CBD4E4", "ratio": "2.62%" }
  ]
}

​
Génération séquentielle d’images

{
  "model": "wan2.7-image-pro",
  "prompt": "Cinematic series: the same stray orange cat, consistent features. First: under cherry blossoms in spring. Second: old street shade in summer. Third: fallen leaves in autumn. Fourth: snow footprints in winter.",
  "enable_sequential": true,
  "n": 4,
  "size": "2K"
}

​
Édition d’une seule image

{
  "model": "wan2.7-image",
  "prompt": "Replace the background with a sunset scene, warm color tones",
  "image_urls": ["https://example.com/portrait.jpg"],
  "size": "2K"
}

​
Référence multi-images / fusion d’éléments

{
  "model": "wan2.7-image-pro",
  "prompt": "Apply the graffiti from image 2 onto the car in image 1",
  "image_urls": [
    "https://example.com/car.webp",
    "https://example.com/paint.webp"
  ],
  "size": "2K"
}

​
Édition interactive (boîte englobante)

bbox_list correspond 1 à 1 à image_urls. Passez [] pour les images sans sélection. 
{
  "model": "wan2.7-image-pro",
  "prompt": "Place the alarm clock from image 1 into the selected area of image 2, blending naturally",
  "image_urls": [
    "https://example.com/clock.webp",
    "https://example.com/desk.webp"
  ],
  "bbox_list": [
    [],
    [[989, 515, 1138, 681]]
  ],
  "size": "2K"
}
Interroger les résultatsLa génération d’images est asynchrone. Interrogez le point de terminaison Statut de tâche à l’aide du task_id retourné jusqu’à ce que status == completed.