Ten poradnik jest na razie tylko po angielsku. →
Parametry żądania
| Parametr | Wymagany | Opis |
|---|---|---|
aspect_ratio | Nie | Kształt kadru: szeroki, kwadratowy albo pionowy. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Domyślnie: 1:1 |
loras | Nie | Wczytaj własne pliki LoRA, by utrwalić styl lub postać. Domyślnie: [] |
output_format | Nie | Format pliku wyniku. jpeg · png · webp · Domyślnie: jpeg |
prompt | Tak | Describe the subject, composition and lighting. If a LoRA has a trigger word, put it first. |
seed | Nie | Ta sama liczba daje powtarzalny wynik. ≥ 0 · ≤ 2147483647 |
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ą.
| Opcja | Kredyty za obraz | ≈ USD |
|---|---|---|
| Standard | 1,8 | 0,018 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 Turbo LoRA w trzech krokach
- 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.
- Wyślij żądanie. Wyślij POST /jobs/createTask z model alibaba/z-image-turbo-lora/text-to-image i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
- 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-lora/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# 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 Turbo LoRA
Ile kosztuje API Z-Image Turbo LoRA?
Z-Image Turbo LoRA kosztuje od 2 kredyty (0,02 USD) za obraz – najtańsze zadanie to „Utwórz 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 Turbo LoRA w API?
Wpisz alibaba/z-image-turbo-lora/text-to-image do zadania Utwórz obraz; alibaba/z-image-turbo-lora/edit do zadania Edytuj obraz w polu model żądania POST /jobs/createTask.
Które LoRA tu działają?
Pliki wytrenowane pod Z-Image Turbo. Na Hugging Face są ich setki; podaj bezpośredni link do pobrania pliku .safetensors. LoRA stworzone dla FLUX, SDXL czy Qwen-Image się nie przeniosą.
Co robi strength w trybie obraz na obraz?
Określa, jak daleko wynik może odejść od źródła. Domyślne 0,8 zachowuje układ i pozę, zmieniając styl; przy 0,6 zmiana jest subtelna; wartości bliskie 1 traktują źródło jako luźną wskazówkę.
Czy mogę łączyć kilka LoRA?
Tak, do trzech na żądanie, każda z własnym scale. Kolejne LoRA zaczynaj od około 0,5; dwie LoRA stylu na pełnej sile zwykle ze sobą konkurują.
Jakie limity ma API Z-Image Turbo LoRA?
Proporcje obrazu: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Długość promptu (znaki): 5,000. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.
Czy mogę wypróbować Z-Image Turbo LoRA bez pisania kodu?
Tak. Playground uruchamia Z-Image Turbo LoRA na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.
Wszystkie modele Z-Image
Z-Image Base LoRA uruchamia pełny, wolniejszy model bazowy dla LoRA wytrenowanych na nim.


