popnow
Zaloguj sięZacznij tworzyć

alibaba/z-image-turbo/text-to-imageOd 2 kredytów za obraz

Z-Image to kompaktowa, 6-miliardowa rodzina obrazowa Tongyi nastawiona na fotorealistyczny wynik w mniej więcej sekundę, opublikowana jako jeden endpoint text-to-image. Pięć proporcji, bezstratny PNG, prompty do 1000 znaków.

Wywołujesz go nazwą modelu alibaba/z-image-turbo/text-to-image w POST /jobs/createTask, od 2 kredyty za obraz (0,02 USD). Nowe konta dostają 30 darmowych kredytów, więc możesz najpierw przetestować go w Playgroundzie.

  • Utwórz obraz
  • Proporcje obrazu: 5
od AlibabaZdobądź klucz APIZ-Image: przykłady i prompty →

Ten poradnik jest na razie tylko po angielsku. →

Parametry żądania

ParametrWymaganyOpis
seedNieTa sama liczba daje powtarzalny wynik. ≥ 0 · ≤ 2147483647
promptTakDescribe the image to generate: subject, composition, style, and lighting.
aspect_ratioNieKształt kadru: szeroki, kwadratowy albo pionowy. 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · Domyślnie: 1:1
output_formatNieFormat pliku wyniku. png · Domyślnie: png
enable_prompt_expansionNieModel dopisuje szczegóły do krótkiego promptu. Domyślnie: false

Ceny

Ceny podajemy w kredytach, tych samych, których używasz na stronie (1 kredyt = 0,01 $). Kwota jest rezerwowana, gdy zadanie zostaje przyjęte, a po zakończeniu rozliczana według rzeczywistego kosztu; za nieudane zadania kredyty wracają.

OpcjaKredyty za obraz≈ USD
Standard1,50,015 USD
enable_prompt_expansion true2,40,024 USD

Każde zadanie jest zaokrąglane w górę do pełnych kredytów, więc jedno uruchomienie na najniższym poziomie kosztuje 2 kredyty za obraz (0,02 USD).

Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.

Szybki start z API

Wywołaj API Z-Image w trzech krokach

  1. Utwórz klucz API. Zaloguj się do PopNow i utwórz klucz w konsoli API. Klucze zaczynają się od sk-popnow- i korzystają z tych samych kredytów co strona.
  2. Wyślij żądanie. Wyślij POST /jobs/createTask z model alibaba/z-image-turbo/text-to-image i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
  3. Odbierz wynik. Odpytuj GET /jobs/recordInfo po ID zadania albo podaj callBackUrl, a wyślemy tam wynik. Gdy zadanie się powiedzie, pobierz pliki z linków wyjściowych.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/z-image-turbo/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1",
    "output_format": "png"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Podmień prompt i linki na własne. Odniesienie do odpowiedzi, odpytywania i callbacku znajdziesz na karcie API.

Pytania o API Z-Image

Ile kosztuje API Z-Image?

Z-Image kosztuje 2 kredyty (0,02 USD) za obraz. Ceny według opcji: Standard 1,5 kredytu za obraz, true 2,4 kredytu za obraz. Kredyty są te same co na stronie (1 kredyt = 0,01 USD), nowe konta dostają 30 darmowych kredytów, a nieudane zadania są zwracane.

Jaka jest nazwa modelu Z-Image w API?

Wpisz alibaba/z-image-turbo/text-to-image do zadania Utwórz obraz w polu model żądania POST /jobs/createTask.

Jak szybki naprawdę jest Z-Image?

Mniej więcej sekunda na kadr z text-to-image. Na tym polega sens tej rodziny: pętla jest na tyle krótka, że sformułowanie traktuje się jak eksperyment, a nie jak zobowiązanie.

Co właściwie kontroluje aspect_ratio?

Wymiary wyniku w pikselach. Każde proporcje odpowiadają stałemu rozmiarowi w okolicach natywnego megapiksela modelu, więc jakość utrzymuje się równo między proporcjami, zamiast rozpadać się na skrajnościach.

Czy mogę odtworzyć wcześniejszy obraz?

Bardzo blisko, jeśli zachowano seed: przy tym samym prompcie, proporcjach i seedzie wynik ląduje tuż obok wcześniejszego kadru, choć seed nie gwarantuje identycznych pikseli. Bez seeda identyczne żądania zwracają różne kadry, więc zapisuj prompt i seed obok każdego materiału, który chcesz zachować.

Dlaczego limit promptu to tylko 1000 znaków?

Tyle maksymalnie przyjmuje ten endpoint: dłuższy prompt zostaje odrzucony przed wysłaniem, a nie po cichu obcięty. Odpowiada to też temu, co kompaktowy model 6B potrafi dobrze wykorzystać – zwięzły opis tematu, światła i faktury wypada tu lepiej niż długa lista ujęć.

Jakie limity ma API Z-Image?

Proporcje obrazu: 1:1 · 4:3 · 3:4 · 16:9 · 9:16; Długość promptu (znaki): 1,000. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.

Czy mogę wypróbować Z-Image bez pisania kodu?

Tak. Playground uruchamia Z-Image na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.

Wszystkie modele Z-Image

Z-Image Turbo LoRA uruchamia tę samą rodzinę z twoimi LoRA i dodaje obraz na obraz.

Więcej o Z-Image