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 · 2:1 · 1:2 · 3:1 · 1:3 · 5:4 · 4:5 · Domyślnie: 1:1 |
background | Nie | Zachowaj, usuń lub zamień tło. opaque · transparent · Domyślnie: opaque |
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. |
mask_url | Nie | Zamaluj obszar, który ma się zmienić. |
output_format | Nie | Format pliku wyniku. jpeg · png · webp · Domyślnie: jpeg |
prompt | Tak | Describe the subject, composition, lighting, and any wording to render. |
resolution | Nie | Rozmiar wyniku. Większy jest ostrzejszy i droższy. 1k · 1.5k · 2k · Domyślnie: 1k |
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 | 5,4 | 0,054 USD |
| resolution 2K | 7,2 | 0,072 USD |
| resolution 1.5K | 10,8 | 0,11 USD |
Każde zadanie jest zaokrąglane w górę do pełnych kredytów, więc jedno uruchomienie na najniższym poziomie kosztuje 6 kredytów za obraz (0,06 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 2.1 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-2.1/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-2.1/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": "1k",
"background": "opaque",
"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 Qwen Image 2.1
Ile kosztuje API Qwen Image 2.1?
Qwen Image 2.1 kosztuje od 6 kredytów (0,06 USD) za obraz – najtańsze zadanie to „Edytuj obraz”. Ceny według opcji: 1K 5,4 kredytu za obraz, 2K 7,2 kredytu za obraz, 1.5K 10,8 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 2.1 w API?
Wpisz alibaba/qwen-image-2.1/text-to-image do zadania Utwórz obraz; alibaba/qwen-image-2.1/edit do zadania Edytuj obraz w polu model żądania POST /jobs/createTask.
Czy to ten model, który Alibaba właśnie otworzyła?
Tak. Wagi Qwen-Image-2.1 otwarto 21 września 2026 roku i tego samego dnia model ruszył tutaj jako hostowane API — bez konfiguracji, bez GPU i bez pobierania wag.
Czy mogę edytować tylko fragment obrazu zamiast całego kadru?
Tak, i mamy to sprawdzone. Zaznacz obszar na obrazie referencyjnym — narysowanym kółkiem albo zamalowaną plamą — i opisz zmianę, która ma zajść w jego wnętrzu, dorzucając polecenie usunięcia samego zaznaczenia. W naszym teście zmiana trafiła dokładnie w zaznaczony obszar, a reszta kadru została nietknięta.
Ile obrazów referencyjnych przyjmuje edycja?
Od jednego do dziesięciu. W prompcie napisz, co wnosi każdy z nich, bo model sam nie przypisuje ról. Każda dołożona referencja podnosi wycenę, więc wysyłaj tylko te, które naprawdę pracują.
Czy ustalony seed odtwarza ten sam obraz?
Nie. Wysłaliśmy ten sam prompt z tym samym seedem dwa razy i dostaliśmy dwa różne kadry. Używaj seeda, żeby utrzymać wspólny charakter serii, a gdy potrzebujesz dokładnie tego samego obrazu, zachowaj zwrócony zasób.
Czy jest negatywny prompt?
Nie w tej rodzinie. Wykluczenia wpisz do głównego promptu — mieści 5000 znaków, czyli aż nadto miejsca, żeby powiedzieć zarówno co ma być w kadrze, jak i czego w nim być nie może.
Jakie limity ma API Qwen Image 2.1?
Rozdzielczości: 1K · 1.5K · 2K; Proporcje obrazu: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9; Obrazy referencyjne: 10; 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 2.1 bez pisania kodu?
Tak. Playground uruchamia Qwen Image 2.1 na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.
Wszystkie modele Qwen Image
Qwen Image 2.1 Turbo jest szybszy i tańszy do szkiców, a Pro dodaje drobniejszy detal w portretach. Standardowy model leży pomiędzy nimi, z edycją po masce i przezroczystymi wycinkami.
- 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

