Wprowadzenie
Qwen Image 3.0 Pro Edycja obrazu edytuje od jednego do trzech obrazów referencyjnych według polecenia. Z jedną referencją to chirurgiczna zmiana — zapowiedź na okładce, ubranie, światło. Z dwiema lub trzema łączy, pod warunkiem że prompt mówi, co wnosi każde źródło.
Qwen Image 3.0 Pro to najbardziej szczegółowy poziom linii obrazów Qwen od Alibaby: prompty do 5000 znaków, osiem proporcji, poziom 1K lub 2K i edycja z jedną do trzech referencji. Stworzony do kadrów, które idą do publikacji, bez cenzury.
Wybierz tryb Qwen Image 3.0 Pro według materiału wyjściowego
| Materiał wyjściowy | Tryb |
|---|---|
| Pisemna koncepcja artystyczna lub brief projektowy | Qwen Image 3.0 Pro Tekst na obraz |
| Zatwierdzony obraz źródłowy do poprawienia | Qwen Image 3.0 Pro Edycja obrazu |
Najważniejsze funkcje
Kompozycja obrazu z myślą o tekście
Qwen Image 3.0 Pro 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. Nazwij zmianę i nazwij to, co ma zostać identyczne – wszystko niewymienione może zostać narysowane od nowa. od 1 znaków · do 5000 znaków |
image_urls | Tak | Od jednego do trzech publicznie dostępnych 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ł, więc referencja o innym kształcie wróci przeformatowana. Ustaw je świadomie, gdy pierwotny kadr ma przetrwać. |
resolution | Nie | 1k albo 2k, domyślnie 2k. To wybór progu zmienia cenę; każdy obraz referencyjny w |
num_outputs | Nie | Na stałe 1: jeden zmieniony obraz na żądanie. |
enable_prompt_expansion | Nie | W tej rodzinie domyślnie włączone. Uzupełnia ubogie briefy i przepisuje 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ń. Tutaj najbardziej przydaje się przeciw artefaktom, o które prosi sama edycja: szwom ubrań, resztkom liter, zdublowanej biżuterii. do 2000 znaków |
seed | Nie | Ustal go, by porównać dwa sformułowania jednej instrukcji przy identycznym losowaniu; pomiń, gdy zależy ci na prawdziwej zmienności. |
Cennik
| Specyfikacja | Cena |
|---|---|
| $0.04 / obraz |
| $0.075 / obraz |
Zastosowania
Dopracuj dostarczony obraz
Używaj tego trybu, gdy od jednego do trzech zatwierdzonych kadrów ma przejść do wyniku. Wymień je w image_urls w kolejności, w jakiej przywołuje je prompt, i nadaj każdemu rolę — twarz z pierwszego, ubranie z drugiego — bo role nigdy nie są wywnioskowane.
Okładki magazynów i sesje bez cenzury
Zachowaj zatwierdzoną okładkę i w każdym przebiegu zmieniaj jeden element: zapowiedź, ubranie albo światło. Zmiana stylu i tekstu w jednym wywołaniu to moment, w którym twarze się rozjeżdżają, więc rozdziel to na dwa żądania.
Makiety plakatów i reklamy zewnętrznej
Weź zatwierdzony kadr plakatu i na kolejną emisję wymień linijkę daty albo notę prawną. Przytocz stary i nowy ciąg, zostaw aspect_ratio zgodne z kształtem kadru i opisz całą resztę jako niezmienioną.
Makiety opakowań i etykiet
Wyślij render produktu i zmień mu etykietę: przytocz nazwę marki i krótkie hasło, napisz, na jakiej powierzchni się znajdują, i użyj negative_prompt przeciw resztkom napisów ze starej etykiety.
Wskazówki
Wybierz kształt okładki i zostań przy 2k
Do okładek i plakatów wybierz 3:4 albo 2:3; kadr jest komponowany pod ten kształt, a nie w niego przycinany. Zostaw rozdzielczość 2k dla wszystkiego, co zawiera tekst — przewaga tego poziomu znika przy 1k.
Przytocz każdy ciąg i napisz, gdzie stoi
Przy edycji tekstu przytocz stary i nowy ciąg i podaj pozycję, a potem napisz, które elementy mają zostać nietknięte, na przykład winieta. Wszystko, o czym polecenie nie wspomina, może zostać narysowane od nowa.
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 portrait, wardrobe, lighting and grade exactly as they are. Change the cover line from 'THE LATE SHIFT' to 'AFTER HOURS' in the same small caps and the same position, and leave the masthead untouched.
Edycja tekstu z jedną referencją: oba ciągi przytoczone, a winieta wprost chroniona. Dostarcz własną okładkę — wartość image_urls to symbol zastępczy, nie hostowana próbka.
Sprawdź wynik, zanim zaczniesz iterować
Łączenie działa, gdy prompt przypisuje rolę każdej referencji; przy trzech źródłach bez nazwanych ról wychodzi mieszanka, o którą nikt nie prosił. Zmiana tekstu w miejscu wymaga przytoczenia starego i nowego ciągu. Twarze się rozjeżdżają, gdy w jednym wywołaniu zmieniasz styl i tekst, więc rozdziel to na dwa przebiegi.
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-pro/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.
