qwen_image_edit_spicy — Penggunaan dan parameter
Penyuntingan gambar. ID publik: qwen_image_edit_spicy; harga dasar $0.040 per gambar berhasil. Gunakan ID bergaris bawah ini di APIMaster.
qwen_image_edit_spicy
Penyuntingan gambar. ID publik: qwen_image_edit_spicy; harga dasar $0.040 per gambar berhasil. Gunakan ID bergaris bawah ini di APIMaster.
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. |
image · string |
Gambar utama wajib: URL yang dapat diakses atau URI data (data:image/png;base64,...). |
reference_images · string[] | null = null; [] |
Array string opsional, maksimal dua referensi tambahan dalam format URL/URI data. Total maksimal tiga gambar termasuk utama. |
images / image_urls · string[] |
Array gambar terurut alternatif: pertama gambar utama, sisanya maksimal dua referensi. Pilih satu cara input agar tidak duplikat. |
seed · integer | null = null |
Integer opsional atau null, bawaan null; 0 atau null memakai seed acak. Rentang numerik tidak didokumentasikan; jangan gunakan rentang Z Image. |
size · string = auto |
Opsional, hanya auto. Ukuran keluaran mengikuti gambar utama; jangan kirim width/height. |
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 |
Qwen memerlukan satu utama dan maksimal dua referensi. JSON menggabungkan image, images, image_urls, reference_images sesuai urutan; disarankan hanya image dan reference_images. prompt_extend dan ukuran eksplisit tidak didukung; hilangkan resolution. |
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": "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: unggah melalui image, image[] berulang, atau images. Tiap berkas harus gambar berukuran 1 byte–10 MiB; pertama menjadi utama. Gunakan satu kolom berkas. reference_images multipart berupa array JSON string URL/URI data.
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'
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.
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.
Qwen memerlukan satu utama dan maksimal dua referensi. JSON menggabungkan image, images, image_urls, reference_images sesuai urutan; disarankan hanya image dan reference_images. prompt_extend dan ukuran eksplisit tidak didukung; hilangkan resolution.
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 · z-image-spicy-pro
Spesifikasi diperiksa pada 2026-10-30. Kontrak menjelaskan adaptor APIMaster yang diterapkan, bukan API langsung penyedia.
