Wprowadzenie
Qwen Image 3.0 Edycja obrazu przyjmuje od jednego do trzech obrazów referencyjnych i polecenie, a zwraca edytowany wynik. Z jedną referencją to precyzyjna poprawka; z dwiema lub trzema łączy — twarz z jednego, ubranie albo tło z drugiego — pod warunkiem, że prompt mówi, który obraz dostarcza czego.
Qwen Image 3.0 to model obrazów od Alibaby wyspecjalizowany w renderowaniu tekstu: prompty do 5000 znaków, osiem proporcji, poziom 1K lub 2K i endpoint edycji, który czyta od jednej do trzech referencji. Bez cenzury i bez flag do ustawiania.
Wybierz tryb Qwen Image 3.0 według materiału wyjściowego
| Materiał wyjściowy | Tryb |
|---|---|
| Pisemna koncepcja artystyczna lub brief projektowy | Qwen Image 3.0 Tekst na obraz |
| Zatwierdzony obraz źródłowy do poprawienia | Qwen Image 3.0 Edycja obrazu |
Najważniejsze funkcje
Kompozycja obrazu z myślą o tekście
Qwen Image 3.0 przydaje się przy koncepcjach wizualnych, w których dostarczony tekst, kompozycję i obróbkę obrazu trzeba rozważać razem. Traktuj wygenerowane napisy jak szkic projektu i sprawdź je przed publikacją.
Nowa kompozycja i poprawianie źródła to osobne zadania
Tekstu na obraz używaj, by zbudować wizual z pisemnego briefu. Edycji obrazu używaj, gdy istniejący obraz dostarcza tożsamości, układu lub materiału, które muszą zostać zachowane przy konkretnej zmianie.
Najpierw hierarchia, potem dekoracja
Przy plakatach, opakowaniach i koncepcjach kampanii najpierw ustal hierarchię komunikatów i punkt skupienia. Atrakcyjny wynik i tak nie spełnia zadania, jeśli zatwierdzony tekst lub fakty o produkcie nie są przedstawione poprawnie.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Do 5 000 znaków. Napisz, co się zmienia i co ma pozostać identyczne; wszystko, o czym nie wspomnisz, jest otwarte na przerysowanie. od 1 znaków · do 5000 znaków |
image_urls | Tak | Od jednego do trzech publicznie pobieralnych adresów obrazów, do których masz prawa. od 1 elementów · do 3 elementów |
aspect_ratio | Nie | Dotyczy wyniku, a nie źródeł. Referencja o innych proporcjach niż ustawione wraca przekształcona, więc dobieraj je świadomie, gdy chcesz zachować oryginalny kadr. |
resolution | Nie | 1k albo 2k, domyślnie 2k. To wybór progu zmienia cenę; każdy obraz referencyjny w |
num_outputs | Nie | Ustawione na sztywno na 1: jeden zmodyfikowany obraz na żądanie. |
enable_prompt_expansion | Nie | W tej rodzinie domyślnie włączone. Uzupełnia ubogie briefy i przepisuje te szczegółowe, więc wyłącz je, gdy Twój prompt jest już precyzyjnym opisem ujęcia. Domyślnie: |
negative_prompt | Nie | Do 2 000 znaków wykluczeń. do 2000 znaków |
seed | Nie | Na etapie szukania go pomijaj. Ustal go, żeby porównać dwa sformułowania tej samej instrukcji na identycznym losowaniu. |
Cennik
| Specyfikacja | Cena |
|---|---|
| $0.03 / obraz |
| $0.03 / obraz |
Zastosowania
Dopracuj dostarczony obraz
Używaj tego trybu, gdy od jednego do trzech istniejących obrazów ma ustalić obiekt, układ lub materiał. Wymień je w image_urls w kolejności, w jakiej przywołuje je prompt — pierwszy, drugi, trzeci — i napisz, co dostarcza każdy z nich.
Zestawy postaci i serie modowe
Zachowaj postać z zatwierdzonego kadru i w każdym żądaniu zmieniaj jeden szczegół: strój, światło albo pozę. Przypnij seed, gdy porównujesz dwa sformułowania tej samej zmiany, żeby różnicy nie zrobiło losowanie.
Warianty z przetłumaczonym tekstem
Wyślij zatwierdzony kadr do endpointu edycji i zmień tylko słowa na szyldzie. Poza, strój, światło i gradacja kolorów są opisane jako niezmienione, więc wariant różni się tekstem, a nie całym obrazem.
Scenografie dla hotelarstwa i aranżacji wnętrz
Wyślij zatwierdzony kadr pokoju albo baru i dodaj lub wymień oznakowanie: zawieszkę na drzwi, tablicę z menu, linijkę neonu. Przytocz nowy tekst, a jeśli szyld już istnieje, przytocz także stary ciąg znaków.
Wskazówki
Najpierw proporcja i poziom
aspect_ratio dotyczy wyniku, nie źródeł: referencja o innym kształcie wraca przekształcona, więc dopasuj proporcję świadomie, gdy oryginalny kadr ma przetrwać. Dla wszystkiego z tekstem zostaw rozdzielczość 2k; każdy obraz referencyjny dolicza się też do wyceny.
Opisz scenę i przytocz tekst dosłownie
Najpierw napisz, co ma zostać identyczne, potem, co się zmienia; wszystko, o czym nie wspomnisz, może zostać narysowane od nowa. Przy edycji tekstu przytocz stary i nowy ciąg. negative_prompt przyjmuje do 2000 znaków i pomaga na resztki napisów i zdublowaną biżuterię.
Dostosuj dołączony przykład
Zacznij od opublikowanego przykładu z aspect_ratio: 3:4 i resolution: 2k. Wymień obiekt i kierunek kreatywny, ale zachowaj kontrakt wejścia tego trybu.
Keep the bathroom, the mirror, the steam, the woman's reflection, the basin, the lighting and the whole composition exactly as they are. On the blank fogged area of the mirror to the left of her reflection, add two lines of writing drawn in bold red lipstick, thick glossy strokes with clear dark glass showing through where the fog is wiped away, slightly dripping at the ends: the first line reads 'WAIT UP' and the second line below reads 'FOR ME'. The lettering is large, hand-drawn, neatly spelled and clearly legible, and catches the warm bathroom light. Change nothing else.
Napis dodany na powierzchni, która nie jest ani płaska, ani czysta: zaparowane szkło, na którym każde pociągnięcie musi zetrzeć skroploną parę i odsłonić ciemne szkło, z małym zaciekiem na końcach. Polecenie ogranicza edycję do wolnego miejsca na lewo od odbicia i każe zostawić resztę bez zmian. Dostarcz własny kadr — URL to tylko symbol zastępczy.
Sprawdź wynik, zanim zaczniesz iterować
Prompt musi mówić, która referencja dostarcza czego; przy dwóch czy trzech źródłach model sam nie wnioskuje o rolach. Edycja tekstu w miejscu działa, gdy wypiszesz zarówno stary, jak i nowy tekst. Przy mocnych zmianach tożsamość się rozjeżdża, więc zmieniaj jedną rzecz na przebieg, zamiast zmieniać styl i tekst w jednym wywołaniu.
Szybki start z API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-3.0/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
