qwen_image_edit_spicy

Chỉnh sửa ảnh. ID công khai: qwen_image_edit_spicy; giá cơ sở $0.040 cho mỗi ảnh thành công. Dùng ID có dấu gạch dưới này trong APIMaster.

Dùng API key APIMaster với Authorization: Bearer. JSON dùng Content-Type: application/json; multipart để cURL/requests đặt boundary. https://apimaster.ai/v1 đã gồm /v1.

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

Ví dụ dùng endpoint đồng bộ: máy chủ chờ và truy vấn tác vụ đã được nhận. Khách nhận kết quả Images cuối cùng, không phải UUID nhà cung cấp. Đặt thời gian chờ đọc dài, ví dụ 750 giây; không streaming.

Tham số

Trường / kiểu	Quy tắc và mặc định
model · string	Bắt buộc: ID công khai chính xác ở trên.
prompt · string	Chuỗi bắt buộc không rỗng mô tả ảnh hoặc yêu cầu chỉnh sửa.
n · integer = 1	Số nguyên tùy chọn: chỉ 1, mặc định 1.
response_format · string = url	Chuỗi tùy chọn: url (mặc định) hoặc b64_json.
image · string	Ảnh chính bắt buộc: URL truy cập được hoặc URI dữ liệu (data:image/png;base64,...).
reference_images · string[] | null = null; []	Mảng chuỗi tùy chọn, tối đa hai ảnh tham chiếu bổ sung dạng URL/URI dữ liệu. Tổng tối đa ba ảnh gồm ảnh chính.
images / image_urls · string[]	Mảng có thứ tự thay thế: ảnh đầu là chính, tối đa hai ảnh sau là tham chiếu. Chỉ chọn một cách nhập để tránh trùng lặp.
seed · integer | null = null	Số nguyên tùy chọn hoặc null, mặc định null; 0 hoặc null dùng hạt giống ngẫu nhiên. Không có khoảng số công bố; không áp dụng khoảng Z Image.
size · string = auto	Tùy chọn, chỉ auto. Kích thước đầu ra theo ảnh chính; không gửi width/height.
quality · standard; stream · false	Không hỗ trợ: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. Bỏ quality hoặc dùng standard, không có mức chất lượng bổ sung. Tham số phụ lạ bị từ chối.
resolution	Qwen cần một ảnh chính và tối đa hai tham chiếu. JSON gộp image, images, image_urls, reference_images theo thứ tự đó; nên chỉ dùng image và reference_images. Không hỗ trợ prompt_extend và kích thước rõ ràng; bỏ resolution.

Ví dụ

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: tệp qua image, image[] lặp hoặc images. Mỗi tệp phải là ảnh từ 1 byte đến 10 MiB; tệp đầu là chính. Dùng nhất quán một trường. reference_images multipart là mảng JSON chuỗi URL/URI dữ liệu.

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'

Phản hồi và tính phí

HTTP 200 gồm created (giây Unix) và một phần tử data. url là địa chỉ tải ảnh, hãy lưu sớm. b64_json chứa byte ảnh dạng base64. Kiểm tra cả nội dung ảnh.

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

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

Giá cơ sở theo ảnh; hệ số kênh, nhóm và tài khoản hiện có quyết định phí cuối trong chợ mô hình và nhật ký. Kích thước và số tham chiếu được hỗ trợ không có phụ phí riêng; n=1.

qwen_image_edit_spicy

Giới hạn và xử lý lỗi

Không hỗ trợ: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. Bỏ quality hoặc dùng standard, không có mức chất lượng bổ sung. Tham số phụ lạ bị từ chối.

Qwen cần một ảnh chính và tối đa hai tham chiếu. JSON gộp image, images, image_urls, reference_images theo thứ tự đó; nên chỉ dùng image và reference_images. Không hỗ trợ prompt_extend và kích thước rõ ràng; bỏ resolution.

Lỗi 400 cần sửa tham số. Từ chối hoặc thất bại của nhà cung cấp trả về lỗi. Hết giờ, mất kết nối hay biên nhận chưa rõ không chứng minh bị từ chối: giữ ID, kiểm tra nhật ký hoặc hỗ trợ trước POST trả phí mới. Không tự gửi lại tác vụ đã được nhận.

---

Tổng quan API ảnh · z-image-spicy-pro

Đã kiểm tra đặc tả ngày 2026-10-30. Hợp đồng mô tả bộ thích ứng APIMaster đã triển khai, không phải API trực tiếp của nhà cung cấp.

MuleRouter API