z-image-spicy-pro

Tạo ảnh từ văn bản. ID công khai: z-image-spicy-pro; giá cơ sở $0.020 cho mỗi ảnh tạo thành công.

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.
width / height · integer = 1024	Số nguyên tùy chọn, mỗi chiều 256–2560 pixel. Mặc định nhà cung cấp: 1024 × 1024.
size · string	Tùy chọn RỘNGxCAO, ví dụ 512x512, hoặc auto. Phải khớp width/height; bỏ tất cả kích thước để dùng mặc định nhà cung cấp.
seed · integer | null = 0	Số nguyên tùy chọn hoặc null, 0–2147483647; mặc định 0. 0 hoặc null dùng hạt giống ngẫu nhiên, không đảm bảo tái tạo kết quả.
prompt_extend · boolean | null = false	Boolean tùy chọn hoặc null; mặc định false. true bật viết lại và mở rộng prompt; null dùng mặc định.
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	Z Image không nhận ảnh tham chiếu. Dùng size hoặc width/height; bỏ resolution (giá trị cũ 1K được nhận nhưng không đặt kích thước).

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": "z-image-spicy-pro",
  "prompt": "A red paper boat on a calm blue pond, no text.",
  "n": 1,
  "response_format": "url",
  "seed": 0,
  "width": 512,
  "height": 512,
  "prompt_extend": false
}'

Python · requests

import os
import requests

api_base = "https://apimaster.ai/v1"
payload = {
    "model": "z-image-spicy-pro",
    "prompt": "A red paper boat on a calm blue pond, no text.",
    "n": 1,
    "response_format": "url",
    "seed": 0,
    "width": 512,
    "height": 512,
    "prompt_extend": False
}
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)

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.

z-image-spicy-pro

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.

Z Image không nhận ảnh tham chiếu. Dùng size hoặc width/height; bỏ resolution (giá trị cũ 1K được nhận nhưng không đặt kích thước).

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 · qwen_image_edit_spicy

Đã 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