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 · Domyślnie: 1:1 |
enable_prompt_expansion | Nie | Model dopisuje szczegóły do krótkiego promptu. Domyślnie: true |
image_urls | Tak | Zdjęcia do edycji lub połączenia. W prompcie napisz, co wnosi każde z nich. |
negative_prompt | Nie | Czego nie chcesz widzieć. |
num_outputs | Nie | Ile wyników zrobić naraz. ≥ 1 · ≤ 1 · Domyślnie: 1 |
prompt | Tak | Describe the subject, composition, lighting, and any text to render. |
resolution | Nie | Rozmiar wyniku. Większy jest ostrzejszy i droższy. 1k · 2k · Domyślnie: 2k |
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 |
|---|---|---|
| resolution 1K | 6 | 0,06 USD |
| resolution 2K | 11,25 | 0,11 USD |
Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.
Szybki start z API
Wywołaj API Qwen Image 3.0 Pro 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/qwen-image-3.0-pro/edit 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/qwen-image-3.0-pro/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "1:1",
"resolution": "2k",
"num_outputs": 1
}
}'
# 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 Qwen Image 3.0 Pro
Ile kosztuje API Qwen Image 3.0 Pro?
Qwen Image 3.0 Pro kosztuje od 6 kredytów (0,06 USD) za obraz – najtańsze zadanie to „Edytuj obraz”. Ceny według opcji: 1K 6 kredytów za obraz, 2K 11,25 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 Qwen Image 3.0 Pro w API?
Wpisz alibaba/qwen-image-3.0-pro/text-to-image do zadania Utwórz obraz; alibaba/qwen-image-3.0-pro/edit do zadania Edytuj obraz w polu model żądania POST /jobs/createTask.
Czym Qwen Image 3.0 Pro różni się od Qwen Image 3.0?
Ten sam kształt żądania, te same pola, wyższy sufit detalu – najwyraźniej widać to na typografii złożonej z wielu elementów i na drobnej fakturze. Szukaj na 3.0, oddawaj na Pro; promptu nie trzeba między nimi przepisywać.
Ile elementów tekstowych zmieści jedna okładka?
Trzy albo cztery krótkie napisy to zakres, na którym można polegać: winieta, wiersz numeru i jedna lub dwie zapowiedzi. Zacytuj każdy osobno i powiedz, gdzie stoi. Całe akapity tekstu głównego nadal się rozpadają.
Jakich proporcji użyć do okładki?
3:4 albo 2:3. Obie są komponowane pod ten kształt od początku, a to nie to samo co przycięcie kwadratu – postać i tekst są rozplanowane pod kadr, o który poprosiłeś.
Czy mogę edytować istniejącą okładkę zamiast generować ją od nowa?
Tak, na endpoincie image-to-image. Podaj kadr w image_urls, zacytuj stare i nowe brzmienie napisu i nazwij wszystko, co ma zostać bez zmian: pozę, kadr, korekcję koloru.
Czy mogę dostać kilka wariantów jednego układu?
Nie w jednym wywołaniu: num_outputs jest na stałe ustawione na 1. Wyślij ten sam brief jako równoległe żądania bez seeda. Każde zwróci jeden obraz i będzie wycenione osobno, a ponieważ różni je tylko losowanie, wyniki pozostają wprost porównywalne.
Jakie limity ma API Qwen Image 3.0 Pro?
Rozdzielczości: 1K · 2K; Proporcje obrazu: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +2; Obrazy referencyjne: 3; Długość promptu (znaki): 5,000; Największy przesyłany plik: 10 MB. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.
Czy mogę wypróbować Qwen Image 3.0 Pro bez pisania kodu?
Tak. Playground uruchamia Qwen Image 3.0 Pro na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.
Wszystkie modele Qwen Image
Qwen Image 3.0 przyjmuje dokładnie takie same prompty i kosztuje odrobinę mniej, więc to miejsce do eksperymentów. Pro ma wyższy sufit w typografii i drobnych materiałach.
- API Qwen Image 2.1 ProDo sześciu szczegółowych obrazów 2K z jednego promptuOd 6 kredytów za obraz
- API Qwen Image 2.1 TurboSzybkie renderowanie w 8 krokach, do sześciu na promptOd 3 kredytów za obraz
- API Qwen Image 2.1Otwarty model z obrazem 2K i przezroczystym tłemOd 4 kredytów za obraz
- API Qwen Image 2.1 LoRAObrazy i edycja Qwen Image 2.1 z maksymalnie trzema twoimi LoRAOd 5 kredytów za obraz
- API Qwen Image 3.0 ProStaranna typografia i realistyczna skóra, tkaniny i szkłoOd 6 kredytów za obraz
- API Qwen Image 3.0Czytelne szyldy i nagłówki wpisane w obrazOd 5 kredytów za obraz
- API Qwen Image 2Proste obrazy z tekstu i edycja jednego zdjęciaOd 6 kredytów za obraz
- API Qwen Image 2512 LoRARendery i edycja Qwen Image 2512 z twoimi LoRAOd 5 kredytów za obraz
- API Qwen Image Edit 2509 LoRAEdycja Qwen z wieloma zdjęciami, wczytuje twoje LoRAOd 5 kredytów za obraz
- API Qwen Image 1.0 LoRAPierwszy Qwen-Image: czyste napisy i twoje LoRAOd 5 kredytów za obraz

