qwen_image_edit_spicy — Utilisation et paramètres
Retouche d’image. Identifiant public : qwen_image_edit_spicy ; prix de base : $0.040 par image réussie. Utilisez cet identifiant avec traits de soulignement dans APIMaster.
qwen_image_edit_spicy
Retouche d’image. Identifiant public : qwen_image_edit_spicy ; prix de base : $0.040 par image réussie. Utilisez cet identifiant avec traits de soulignement dans APIMaster.
Utilisez une clé API APIMaster avec Authorization: Bearer. JSON : Content-Type: application/json ; pour multipart, laissez cURL/requests définir la boundary. https://apimaster.ai/v1 inclut déjà /v1.
POST https://apimaster.ai/v1/images/generations · application/json
Les exemples sont synchrones : le serveur attend et interroge la tâche déjà acceptée. Le client reçoit le résultat Images final, pas l’UUID fournisseur. Prévoyez un délai de lecture long, par exemple 750 secondes ; pas de streaming.
Paramètres
| Champ / type | Règles et valeurs par défaut |
|---|---|
model · string |
Obligatoire : identifiant public exact indiqué ci-dessus. |
prompt · string |
Chaîne obligatoire non vide décrivant l’image ou la modification. |
n · integer = 1 |
Entier facultatif : uniquement 1, valeur par défaut 1. |
response_format · string = url |
Chaîne facultative : url (par défaut) ou b64_json. |
image · string |
Image principale obligatoire : URL accessible ou URI de données (data:image/png;base64,...). |
reference_images · string[] | null = null; [] |
Tableau facultatif de chaînes : au plus deux références supplémentaires en URL/URI de données. Trois images au total, principale comprise. |
images / image_urls · string[] |
Autre tableau ordonné : première image principale, puis au plus deux références. Choisissez une seule convention pour éviter les doublons. |
seed · integer | null = null |
Entier facultatif ou null, défaut null ; 0 ou null utilise une graine aléatoire. Aucune plage numérique documentée ; ne reprenez pas celle de Z Image. |
size · string = auto |
Facultatif : uniquement auto. Les dimensions suivent l’image principale ; ne transmettez pas width/height. |
quality · standard; stream · false |
Non pris en charge : n>1, stream=true, mask/mask_url, style, background, output_format et watermark. Omettez quality ou utilisez standard, sans palier supplémentaire. Les paramètres supplémentaires inconnus sont refusés. |
resolution |
Qwen exige une principale et au plus deux références. JSON fusionne image, images, image_urls, reference_images dans cet ordre ; préférez seulement image et reference_images. Pas de prompt_extend ni de dimensions explicites ; omettez resolution. |
Exemples
cURL · JSON
curl --max-time 750 'https://apimaster.ai/v1/images/generations' \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "qwen_image_edit_spicy",
"prompt": "Change the red paper boat to blue. Keep the pond and lighting unchanged.",
"n": 1,
"response_format": "url",
"seed": 0,
"image": "https://example.com/primary.png",
"reference_images": [
"https://example.com/reference.png"
]
}'
Python · requests
import os
import requests
api_base = "https://apimaster.ai/v1"
payload = {
"model": "qwen_image_edit_spicy",
"prompt": "Change the red paper boat to blue. Keep the pond and lighting unchanged.",
"n": 1,
"response_format": "url",
"seed": 0,
"image": "https://example.com/primary.png",
"reference_images": [
"https://example.com/reference.png"
]
}
response = requests.post(
api_base + "/images/generations",
headers={"Authorization": "Bearer " + os.environ["APIMASTER_API_KEY"]},
json=payload,
timeout=(20, 750),
)
response.raise_for_status()
result = response.json()
print(result)
cURL · multipart
Multipart /images/edits : fichiers via image, image[] répété ou images. Chaque fichier doit être une image de 1 octet à 10 MiB ; le premier est la principale. Gardez un seul type de champ. reference_images multipart est un tableau JSON de chaînes URL/URI de données.
curl --max-time 750 'https://apimaster.ai/v1/images/edits' \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-F 'model=qwen_image_edit_spicy' \
-F 'prompt=Change the red paper boat to blue.' \
-F 'n=1' \
-F 'response_format=b64_json' \
-F 'seed=0' \
-F 'image[]=@primary.png' \
-F 'image[]=@reference.png'
Réponses et facturation
HTTP 200 contient created (secondes Unix) et un seul élément data. url est l’adresse de téléchargement ; enregistrez rapidement l’image. b64_json contient les octets en base64. Vérifiez aussi le contenu.
{"created": 1793380000, "data": [{"url": "https://example.com/generated.png"}]}
{"created": 1793380000, "data": [{"b64_json": "BASE64_IMAGE_BYTES"}]}
Prix de base par image ; les coefficients existants du canal, du groupe et du compte déterminent le débit final dans la place de marché et les journaux. Les dimensions et références prises en charge ne coûtent pas de supplément distinct ; n=1.
Limites et dépannage
Non pris en charge : n>1, stream=true, mask/mask_url, style, background, output_format et watermark. Omettez quality ou utilisez standard, sans palier supplémentaire. Les paramètres supplémentaires inconnus sont refusés.
Qwen exige une principale et au plus deux références. JSON fusionne image, images, image_urls, reference_images dans cet ordre ; préférez seulement image et reference_images. Pas de prompt_extend ni de dimensions explicites ; omettez resolution.
Corrigez les paramètres après une erreur 400. Les refus et échecs fournisseur sont renvoyés comme erreurs. Un délai dépassé, une déconnexion ou un reçu inconnu ne prouvent pas un refus : conservez l’ID de requête, vérifiez les journaux ou contactez le support avant un autre POST payant. Aucune nouvelle soumission automatique d’une tâche acceptée.
Vue d’ensemble de l’API image · z-image-spicy-pro
Spécification fournisseur vérifiée le 2026-10-30. Ce contrat décrit l’adaptateur APIMaster déployé, pas directement l’API fournisseur.
