z-image-spicy-pro

Teks ke gambar. ID model publik: z-image-spicy-pro; harga dasar $0.020 per gambar yang berhasil dibuat.

Gunakan API key APIMaster dengan Authorization: Bearer. JSON: Content-Type: application/json; untuk multipart biarkan cURL/requests mengatur boundary. https://apimaster.ai/v1 sudah mencakup /v1.

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

Contoh memakai endpoint sinkron: server menunggu dan memeriksa tugas yang sudah diterima. Klien mendapat hasil Images akhir, bukan UUID penyedia. Pakai timeout baca panjang, misalnya 750 detik; tanpa streaming.

Parameter

Kolom / tipe	Aturan dan nilai bawaan
model · string	Wajib: ID publik persis seperti di atas.
prompt · string	String wajib yang tidak kosong, berisi deskripsi gambar atau instruksi edit.
n · integer = 1	Integer opsional: hanya 1, bawaan 1.
response_format · string = url	String opsional: url (bawaan) atau b64_json.
width / height · integer = 1024	Integer opsional, masing-masing 256–2560 piksel. Bawaan penyedia: 1024 × 1024.
size · string	Opsional LEBARxTINGGI, misalnya 512x512, atau auto. Harus cocok dengan width/height; hilangkan semua ukuran untuk bawaan penyedia.
seed · integer | null = 0	Integer opsional atau null, 0–2147483647, bawaan 0. 0 atau null memakai seed acak, tanpa jaminan hasil dapat direproduksi.
prompt_extend · boolean | null = false	Boolean opsional atau null, bawaan false. true mengaktifkan penulisan ulang dan perluasan prompt; null memakai bawaan.
quality · standard; stream · false	Tidak didukung: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. Hilangkan quality atau gunakan standard, tanpa tingkat kualitas tambahan. Parameter ekstra tak dikenal ditolak.
resolution	Z Image tidak menerima referensi. Gunakan size atau width/height; hilangkan resolution (nilai lama 1K diterima tanpa mengatur ukuran).

Contoh

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)

Respons dan penagihan

HTTP 200 berisi created (detik Unix) dan satu elemen data. url adalah alamat unduhan; segera simpan gambar. b64_json berisi byte base64. Periksa isi gambar juga.

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

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

Harga dasar per gambar; pengali kanal, grup, dan akun yang ada menentukan biaya akhir di marketplace dan log. Ukuran dan jumlah referensi yang didukung tidak dikenai biaya tambahan terpisah; n=1.

z-image-spicy-pro

Batasan dan pemecahan masalah

Tidak didukung: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. Hilangkan quality atau gunakan standard, tanpa tingkat kualitas tambahan. Parameter ekstra tak dikenal ditolak.

Z Image tidak menerima referensi. Gunakan size atau width/height; hilangkan resolution (nilai lama 1K diterima tanpa mengatur ukuran).

Perbaiki parameter saat 400. Penolakan/kegagalan penyedia dikembalikan sebagai error. Timeout, koneksi putus, atau tanda terima tidak diketahui bukan bukti penolakan: simpan ID, periksa log atau hubungi dukungan sebelum POST berbayar baru. Tugas yang diterima tidak otomatis dikirim ulang.

---

Ikhtisar API gambar · qwen_image_edit_spicy

Spesifikasi diperiksa pada 2026-10-30. Kontrak menjelaskan adaptor APIMaster yang diterapkan, bukan API langsung penyedia.

MuleRouter API