Wprowadzenie
Qwen Image 2 Edycja obrazu przyjmuje dokładnie jeden obraz referencyjny i polecenie, a zwraca jeden edytowany wynik: z nowym światłem, w nowym stylu, w innym stroju albo z dodanym napisem — tak, jak opisuje prompt.
Qwen Image 2 to uniwersalny model obrazów od Alibaby: prompty do 800 znaków czytane natywnie po chińsku lub po angielsku, pięć proporcji w trybie tekst na obraz i endpoint edycji, który przerabia jedną referencję w wybranych przez ciebie proporcjach. Jedno żądanie to jeden obraz, a opcjonalny seed pozwala zatrzymać losowanie, gdy porównujesz wyniki.
Wybierz tryb Qwen Image 2 według materiału wyjściowego
| Materiał wyjściowy | Tryb |
|---|---|
| Pisemna koncepcja artystyczna lub brief projektowy | Qwen Image 2 Tekst na obraz |
| Zatwierdzony obraz źródłowy do poprawienia | Qwen Image 2 Edycja obrazu |
Najważniejsze funkcje
Prompty w dwóch językach
Qwen Image 2 czyta bezpośrednio prompty chińskie i angielskie, więc zespół może pracować w języku, w którym brief jest najjaśniejszy, bez przepisywania go przy przekazaniu.
Pisemna zmiana jednego dostarczonego obrazu
Tryb edycji zaczyna się od jednego dostarczonego obrazu i pisemnego polecenia. Wybierz go, gdy tożsamość albo kompozycja już istnieją, a ocenie podlega zamierzona zmiana, nie nowa koncepcja.
Dwa wyraźnie różne punkty wyjścia
Tekst na obraz służy do zbudowania nowej sceny z koncepcji artystycznej, edycja — do poprawiania istniejącego obrazu. Jeśli najpierw wybierzesz materiał wyjściowy, nie ocenisz briefu edycji tak, jakby był nową generacją.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Do 800 znaków opisujących wynik, a nie źródło. Napisz, co ma pozostać identyczne, a co się zmienia; wszystko, czego nie napiszesz, może odpłynąć. od 1 znaków · do 800 znaków |
image_urls | Tak | Dokładnie jeden publicznie dostępny adres URL w formacie jpeg, png lub webp do obrazu, do którego masz prawa. Drugi obraz zostaje odrzucony, zanim żądanie opuści platformę. od 1 elementów · do 1 elementów |
aspect_ratio | Nie | Domyślnie 1:1, a do tego 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 i 21:9. Wynik nie przejmuje kształtu źródła, więc ustaw proporcję swojego zdjęcia zawsze, gdy liczą się jego proporcje. |
seed | Nie | Pomiń go, aby przy każdym wywołaniu losować od nowa; ustaw go, żeby porównać dwa sformułowania tej samej edycji przy identycznym losowaniu. |
Cennik
$0.035 / obraz
Zastosowania
Dopracuj dostarczony obraz
Używaj tego trybu, gdy istniejące zdjęcie ma ustalić obiekt, kompozycję lub styl. Wyślij je jako jedyny element image_urls, napisz, co się zmienia, a co ma zostać identyczne, i porównaj wynik ze źródłem w docelowym rozmiarze.
Produkt w nowej scenie
Wyślij zdjęcie produktu i opisz otoczenie, w którym ma się znaleźć, łącznie ze światłem, które ma na niego padać. Jedno wywołanie, jeden kadr. Jeśli otoczenie ma pochodzić z drugiego zdjęcia, użyj modelu edycji, który przyjmuje kilka referencji.
Dwujęzyczna produkcja kampanii
Dostosuj zatwierdzony key visual do innego rynku, prosząc o napis na pustej powierzchni — wpisany do promptu dokładnie tak, jak ma wyglądać, po chińsku albo po angielsku. Ogranicz się do krótkiego ciągu: szyldy i dłuższe teksty to zadanie linii Qwen Image 3.0.
Postacie i kostiumy
Zachowaj osobę z jednego zdjęcia i opisz słowami nowe ubranie, łącznie z tkaniną i połyskiem. Ustaw aspect_ratio na kształt zdjęcia — domyślnie jest 1:1 — żeby wynik nie zamienił się w kwadrat, o który nie prosiłeś.
Wskazówki
Najpierw kadr, potem tekst
Kształt wyniku wynika z aspect_ratio, a nie ze źródła. Domyślnie jest to 1:1, a do wyboru jest osiem proporcji, w tym 3:2, 2:3 i 21:9; ustaw tę, która pasuje do zdjęcia, zanim napiszesz polecenie.
800 znaków na jedną kompletną scenę
Opisuj wynik, nie źródło. Najpierw napisz, co ma zostać identyczne, potem, co się zmienia, a resztę poświęć nowej scenografii i światłu — wszystko, czego nie napiszesz, może się rozjechać.
Dostosuj dołączony przykład
Zacznij od opublikowanego przykładu i wymień kierunek kreatywny, zachowując kontrakt wejścia tego trybu.
Keep the woman and her satin robe from the image. Place her leaning on the bar of a narrow neon-lit cocktail lounge, and match the warm red lantern light onto her face and shoulders so it reads as one photograph.
Przeniesienie sceny z jedną referencją: kobieta i szlafrok zostają, neonowy bar jest opisany słowami, a dopasowanie światła zapisane wprost. Obraz musi pochodzić od ciebie — URL w przykładzie to tylko symbol zastępczy, nie hostowana próbka.
Sprawdź wynik, zanim zaczniesz iterować
Nie ma tu suwaka siły i przyjmowana jest dokładnie jedna referencja — druga zostaje odrzucona, zanim żądanie opuści platformę. aspect_ratio domyślnie wynosi 1:1 i nie podąża za źródłem, więc pionowe zdjęcie wróci kwadratowe, jeśli nie ustawisz proporcji. Ile zostanie ze źródła, zależy od tego, jak konkretne jest polecenie. Przypnij seed, gdy chcesz porównać dwa sformułowania tej samej edycji na identycznym losowaniu.
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-2/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.
