z-image-spicy-pro — Kullanım ve parametreler
Metinden görüntü. Genel model kimliği z-image-spicy-pro; taban fiyat başarıyla üretilen görüntü başına $0.020.
z-image-spicy-pro
Metinden görüntü. Genel model kimliği z-image-spicy-pro; taban fiyat başarıyla üretilen görüntü başına $0.020.
APIMaster API anahtarını Authorization: Bearer ile kullanın. JSON için Content-Type: application/json; multipart boundary değerini cURL/requests ayarlasın. https://apimaster.ai/v1 zaten /v1 içerir.
POST https://apimaster.ai/v1/images/generations · application/json
Örnekler eşzamanlı uç noktalar kullanır: sunucu kabul edilen görevi sorgulayarak bekler. İstemci sağlayıcı UUID’si yerine son Images sonucunu alır. Okuma süresini uzun tutun, ör. 750 saniye; akış kullanmayın.
Parametreler
| Alan / tür | Kurallar ve varsayılanlar |
|---|---|
model · string |
Zorunlu: yukarıdaki tam genel model kimliği. |
prompt · string |
Görüntüyü veya düzenleme talimatını açıklayan zorunlu, boş olmayan metin. |
n · integer = 1 |
İsteğe bağlı tamsayı: yalnızca 1, varsayılan 1. |
response_format · string = url |
İsteğe bağlı metin: url (varsayılan) veya b64_json. |
width / height · integer = 1024 |
İsteğe bağlı tamsayılar, her biri 256–2560 piksel. Sağlayıcı varsayılanı 1024 × 1024. |
size · string |
İsteğe bağlı GENİŞLİKxYÜKSEKLİK, ör. 512x512, veya auto. width/height ile eşleşmeli; sağlayıcı varsayılanı için tüm boyutları atlayın. |
seed · integer | null = 0 |
İsteğe bağlı tamsayı veya null, 0–2147483647; varsayılan 0. 0 veya null rastgele tohum kullanır, tekrarlanabilirliği garanti etmez. |
prompt_extend · boolean | null = false |
İsteğe bağlı boolean veya null; varsayılan false. true istemi yeniden yazma/genişletmeyi açar; null varsayılanı kullanır. |
quality · standard; stream · false |
Desteklenmez: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. quality atlanmalı veya standard olmalı, ek kalite kademesi yoktur. Bilinmeyen ek parametreler reddedilir. |
resolution |
Z Image referans kabul etmez. size veya width/height kullanın; resolution atlayın (eski 1K kabul edilir fakat boyut belirlemez). |
Örnekler
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)
Yanıtlar ve ücretlendirme
HTTP 200, created (Unix saniyesi) ve tek öğeli data içerir. url indirme adresidir; görüntüyü zamanında kaydedin. b64_json base64 görüntü baytlarıdır. İçeriği de doğrulayın.
{"created": 1793380000, "data": [{"url": "https://example.com/generated.png"}]}
{"created": 1793380000, "data": [{"b64_json": "BASE64_IMAGE_BYTES"}]}
Taban fiyat görüntü başınadır; mevcut kanal, grup ve hesap çarpanları pazaryeri ve günlüklerdeki son ücreti belirler. Desteklenen boyut ve referans sayısı ayrı ek ücret getirmez; n=1.
Sınırlar ve sorun giderme
Desteklenmez: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. quality atlanmalı veya standard olmalı, ek kalite kademesi yoktur. Bilinmeyen ek parametreler reddedilir.
Z Image referans kabul etmez. size veya width/height kullanın; resolution atlayın (eski 1K kabul edilir fakat boyut belirlemez).
400 için parametreleri düzeltin. Sağlayıcı retleri ve hataları hata olarak döner. Zaman aşımı, kopma veya bilinmeyen makbuz ret kanıtı değildir: kimliği saklayın, yeni ücretli POST öncesinde günlükleri veya desteği kontrol edin. Kabul edilen görev otomatik yeniden gönderilmez.
Görüntü API özeti · qwen_image_edit_spicy
Sağlayıcı belirtimi 2026-10-30 tarihinde kontrol edildi. Sözleşme doğrudan sağlayıcı API’sini değil, dağıtılmış APIMaster bağdaştırıcısını açıklar.
