qwen_image_edit_spicy

Edição de imagem. ID público: qwen_image_edit_spicy; preço base: $0.040 por imagem bem-sucedida. Use este ID com sublinhados no APIMaster.

Use uma chave API APIMaster com Authorization: Bearer. JSON: Content-Type: application/json; para multipart deixe cURL/requests gerar o boundary. https://apimaster.ai/v1 já inclui /v1.

POST https://apimaster.ai/v1/images/generations · application/json

Os exemplos são síncronos: o servidor aguarda e consulta a tarefa já aceita. O cliente recebe o resultado Images final, não o UUID do provedor. Use timeout de leitura amplo, como 750 segundos; sem streaming.

Parâmetros

Campo / tipo	Regras e padrões
model · string	Obrigatório: ID público exato indicado acima.
prompt · string	Texto obrigatório não vazio com a descrição ou instrução de edição.
n · integer = 1	Inteiro opcional: somente 1, padrão 1.
response_format · string = url	Texto opcional: url (padrão) ou b64_json.
image · string	Imagem principal obrigatória: URL acessível ou URI de dados (data:image/png;base64,...).
reference_images · string[] | null = null; []	Array opcional de textos, até duas referências adicionais como URL/URI de dados. Até três imagens no total, incluindo a principal.
images / image_urls · string[]	Array ordenado alternativo: primeira imagem principal, até duas referências restantes. Use apenas uma convenção para evitar duplicatas.
seed · integer | null = null	Inteiro opcional ou null, padrão null; 0 ou null usa semente aleatória. Sem intervalo numérico documentado; não aplique o de Z Image.
size · string = auto	Opcional: somente auto. Dimensões seguem a imagem principal; não envie width/height.
quality · standard; stream · false	Não suportados: n>1, stream=true, mask/mask_url, style, background, output_format e watermark. Omita quality ou use standard, sem nível adicional. Parâmetros extras desconhecidos são recusados.
resolution	Qwen exige uma principal e até duas referências. JSON combina image, images, image_urls, reference_images nessa ordem; prefira apenas image e reference_images. Não use prompt_extend nem dimensões explícitas; omita resolution.

Exemplos

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: arquivos em image, image[] repetido ou images. Cada arquivo deve ser imagem de 1 byte a 10 MiB; o primeiro é principal. Use um mesmo campo. reference_images multipart é um array JSON de textos URL/URI de dados.

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'

Respostas e cobrança

HTTP 200 inclui created (segundos Unix) e um único item data. url é o endereço para download; salve rapidamente. b64_json contém bytes em base64. Verifique também o conteúdo.

{"created": 1793380000, "data": [{"url": "https://example.com/generated.png"}]}

{"created": 1793380000, "data": [{"b64_json": "BASE64_IMAGE_BYTES"}]}

Preço base por imagem; multiplicadores existentes de canal, grupo e conta determinam a cobrança final no marketplace e nos logs. Dimensões e referências suportadas não têm acréscimo separado; n=1.

qwen_image_edit_spicy

Limites e resolução de problemas

Não suportados: n>1, stream=true, mask/mask_url, style, background, output_format e watermark. Omita quality ou use standard, sem nível adicional. Parâmetros extras desconhecidos são recusados.

Qwen exige uma principal e até duas referências. JSON combina image, images, image_urls, reference_images nessa ordem; prefira apenas image e reference_images. Não use prompt_extend nem dimensões explícitas; omita resolution.

Corrija parâmetros após erro 400. Recusas e falhas do provedor retornam erros. Timeout, desconexão ou recibo desconhecido não provam recusa: guarde o ID, consulte logs ou suporte antes de outro POST pago. Tarefas aceitas não são reenviadas automaticamente.

---

Visão geral da API de imagens · z-image-spicy-pro

Especificação verificada em 2026-10-30. Este contrato descreve o adaptador APIMaster publicado, não a API direta do provedor.

MuleRouter API