APIMaster.ai

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.

z-image-spicy-pro

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.

MuleRouter API