qwen_image_edit_spicy — Uso y parámetros
Edición de imágenes. ID público: qwen_image_edit_spicy; precio base: $0.040 por imagen correcta. Use este ID con guiones bajos en APIMaster.
qwen_image_edit_spicy
Edición de imágenes. ID público: qwen_image_edit_spicy; precio base: $0.040 por imagen correcta. Use este ID con guiones bajos en APIMaster.
Use una clave API de APIMaster con Authorization: Bearer. JSON: Content-Type: application/json; en multipart deje que cURL/requests genere el boundary. https://apimaster.ai/v1 ya incluye /v1.
POST https://apimaster.ai/v1/images/generations · application/json
Los ejemplos son síncronos: el servidor espera y consulta la tarea ya aceptada. El cliente recibe el resultado Images final, no el UUID del proveedor. Configure un tiempo de lectura amplio, por ejemplo 750 segundos; sin streaming.
Parámetros
| Campo / tipo | Reglas y valores predeterminados |
|---|---|
model · string |
Obligatorio: ID público exacto indicado arriba. |
prompt · string |
Cadena obligatoria no vacía con la descripción o instrucción de edición. |
n · integer = 1 |
Entero opcional: solo 1, predeterminado 1. |
response_format · string = url |
Cadena opcional: url (predeterminada) o b64_json. |
image · string |
Imagen principal obligatoria: URL accesible o URI de datos (data:image/png;base64,...). |
reference_images · string[] | null = null; [] |
Array opcional de cadenas, máximo dos referencias adicionales en URL/URI de datos. Hasta tres imágenes en total, incluida la principal. |
images / image_urls · string[] |
Array ordenado alternativo: primera imagen principal y hasta dos referencias restantes. Use una sola convención para evitar duplicados. |
seed · integer | null = null |
Entero opcional o null, predeterminado null; 0 o null usa semilla aleatoria. No hay rango numérico documentado; no aplique el de Z Image. |
size · string = auto |
Opcional: solo auto. Las dimensiones siguen la imagen principal; no envíe width/height. |
quality · standard; stream · false |
No admitidos: n>1, stream=true, mask/mask_url, style, background, output_format y watermark. Omita quality o use standard, sin nivel adicional. Se rechazan parámetros extra desconocidos. |
resolution |
Qwen exige una principal y hasta dos referencias. JSON combina image, images, image_urls, reference_images en ese orden; prefiera solo image y reference_images. No admite prompt_extend ni dimensiones explícitas; omita resolution. |
Ejemplos
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: archivos con image, image[] repetido o images. Cada archivo debe ser una imagen de 1 byte a 10 MiB; el primero es la principal. Use un mismo campo. reference_images multipart es un array JSON de cadenas URL/URI de datos.
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'
Respuestas y facturación
HTTP 200 contiene created (segundos Unix) y un único elemento en data. url es una dirección descargable; guarde pronto la imagen. b64_json contiene sus bytes en base64. Verifique también el contenido.
{"created": 1793380000, "data": [{"url": "https://example.com/generated.png"}]}
{"created": 1793380000, "data": [{"b64_json": "BASE64_IMAGE_BYTES"}]}
Precio base por imagen; los multiplicadores existentes del canal, grupo y cuenta determinan el cargo final en el mercado y los registros. Los tamaños y referencias admitidos no tienen recargo separado; n=1.
Límites y solución de problemas
No admitidos: n>1, stream=true, mask/mask_url, style, background, output_format y watermark. Omita quality o use standard, sin nivel adicional. Se rechazan parámetros extra desconocidos.
Qwen exige una principal y hasta dos referencias. JSON combina image, images, image_urls, reference_images en ese orden; prefiera solo image y reference_images. No admite prompt_extend ni dimensiones explícitas; omita resolution.
Corrija los parámetros tras un error 400. Los rechazos y fallos del proveedor se devuelven como errores. Un timeout, desconexión o recibo desconocido no demuestra rechazo: conserve el ID, consulte registros o soporte antes de otro POST de pago. No se reenvían automáticamente tareas aceptadas.
Resumen de la API de imágenes · z-image-spicy-pro
Especificación del proveedor comprobada el 2026-10-30. Este contrato describe el adaptador APIMaster desplegado, no la API directa del proveedor.
