z-image-spicy-pro

Tekst na obraz. Publiczny ID: z-image-spicy-pro; cena bazowa: $0.020 za poprawnie wygenerowany obraz.

Użyj klucza API APIMaster z Authorization: Bearer. JSON: Content-Type: application/json; granicę multipart ustawia cURL/requests. https://apimaster.ai/v1 już zawiera /v1.

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

Przykłady są synchroniczne: serwer czeka i odpytuje już przyjęte zadanie. Klient otrzymuje końcowy wynik Images, nie UUID dostawcy. Ustaw długi limit odczytu, np. 750 sekund; bez streamingu.

Parametry

Pole / typ	Reguły i wartości domyślne
model · string	Wymagane: dokładny publiczny ID powyżej.
prompt · string	Wymagany niepusty tekst z opisem obrazu lub instrukcją edycji.
n · integer = 1	Opcjonalna liczba całkowita: tylko 1, domyślnie 1.
response_format · string = url	Opcjonalny tekst: url (domyślnie) lub b64_json.
width / height · integer = 1024	Opcjonalne liczby całkowite, każda 256–2560 pikseli. Domyślnie u dostawcy 1024 × 1024.
size · string	Opcjonalnie SZEROKOŚĆxWYSOKOŚĆ, np. 512x512, albo auto. Musi zgadzać się z width/height; pominięcie wszystkich wymiarów wybiera domyślne dostawcy.
seed · integer | null = 0	Opcjonalna liczba całkowita lub null, 0–2147483647, domyślnie 0. 0 lub null oznacza losowe ziarno, bez gwarancji powtarzalności.
prompt_extend · boolean | null = false	Opcjonalny boolean lub null; domyślnie false. true włącza przepisywanie i rozwijanie promptu, null używa wartości domyślnej.
quality · standard; stream · false	Nieobsługiwane: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. quality pomiń lub ustaw standard, bez dodatkowego poziomu. Nieznane dodatkowe parametry są odrzucane.
resolution	Z Image nie przyjmuje referencji. Użyj size lub width/height; pomiń resolution (stare 1K jest dozwolone bez ustawienia wymiarów).

Przykłady

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)

Odpowiedzi i rozliczenia

HTTP 200 zawiera created (sekundy Unix) i jeden element data. url to adres pobierania, zapisz obraz szybko. b64_json to bajty base64. Sprawdź także zawartość obrazu.

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

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

Cena bazowa za obraz; istniejące mnożniki kanału, grupy i konta określają końcową opłatę w katalogu i logach. Obsługiwane rozmiary i referencje bez osobnej dopłaty; n=1.

z-image-spicy-pro

Ograniczenia i diagnostyka

Nieobsługiwane: n>1, stream=true, mask/mask_url, style, background, output_format, watermark. quality pomiń lub ustaw standard, bez dodatkowego poziomu. Nieznane dodatkowe parametry są odrzucane.

Z Image nie przyjmuje referencji. Użyj size lub width/height; pomiń resolution (stare 1K jest dozwolone bez ustawienia wymiarów).

Przy 400 popraw parametry. Odmowy i awarie dostawcy zwracają błędy. Timeout, rozłączenie lub nieznane potwierdzenie nie dowodzą odmowy: zachowaj ID, sprawdź logi lub wsparcie przed kolejnym płatnym POST. Przyjęte zadania nie są automatycznie wysyłane ponownie.

---

Przegląd API obrazów · qwen_image_edit_spicy

Specyfikację sprawdzono 2026-10-30. Kontrakt opisuje wdrożony adapter APIMaster, a nie bezpośrednie API dostawcy.

MuleRouter API