Wprowadzenie
Wan 2.7 Pro Edycja obrazu przerabia dostarczone obrazy, wprowadzając ukierunkowaną zmianę. Używaj jej, gdy obraz źródłowy zawiera szczegóły, które muszą pozostać rozpoznawalne, a zmienia się decyzja lokalna lub stylistyczna.
Wybierz tryb Wan 2.7 Pro według materiału wyjściowego
| Co masz na starcie | Tryb |
|---|---|
| pisemny brief wizualny | Wan 2.7 Pro Tekst na obraz |
| obraz, który wymaga ukierunkowanej zmiany | Wan 2.7 Pro Edycja obrazu |
Najważniejsze funkcje
Do 4K, w text-to-image
Text-to-image domyślnie pracuje tu w 2k, około 4 megapikseli, i sięga 4k, około 16 megapikseli, tam gdzie standardowa rodzina kończy się na 2k. Image-to-image pracuje w 2k. O ten podział właśnie chodzi: po 4k sięgaj, gdy generujesz główny kadr, który będzie przycinany albo drukowany, a nie gdy przekolorowujesz packshot.
Światło świec, skóra i pociągnięcia pędzla
Drugi kadr na tej stronie to malarskie wnętrze: postać na tle podświetlonego parawanu, jedna świeca i kieliszek wina na lakowym stoliku. Miękkie wygaszanie światła, widoczna faktura pędzla i twarz, która czyta się w tym rozmiarze, rozsypują się na małym płótnie jako pierwsze – i dokładnie po to jest to większe.
Utrzymuje każdy człon długiej instrukcji
W image-to-image dodatkowa pojemność idzie w wykonywanie złożonych instrukcji – weź ten przedmiot, połóż go na tamtej powierzchni, dopasuj światło z drugiego obrazu, nie ruszaj skroplin. Rodzina standardowa gubi jeden człon takiej instrukcji częściej niż ta wersja.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Opisz zmianę oraz listę rzeczy, których nie wolno zmieniać. od 1 znaków · do 5000 znaków |
image_urls | Tak | Od jednej do dziewięciu referencji w jednym wywołaniu. Kolejność ma znaczenie: prompt przywołuje je po pozycji, a ostatnia ustala proporcje, gdy |
bounding_boxes | Nie | Opcjonalne prostokąty wskazujące, gdzie ma nastąpić edycja, najwyżej dwa na obraz referencyjny. do 18 elementów |
aspect_ratio | Nie | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2 albo 2:3. Bez wartości domyślnej. |
color_palette | Nie | Opcjonalny motyw kolorystyczny z 3–10 kolorów (zalecane jest 8). od 3 elementów · do 10 elementów |
seed | Nie | Od 0 do 2147483647. Ustal go dla całego zestawu wariantów, tak aby jedyną różnicą między dwiema edycjami był człon, który zmieniłeś. |
Cennik
$0.075 / obraz
Zastosowania
Dostosuj zatwierdzony obraz do nowego kontekstu kampanii
Wyślij packshot i powierzchnię docelową jako dwie opisane referencje i poproś o dopasowanie kierunku światła i temperatury barwowej drugiej z nich. Skroplona para, etykieta i kształt szkła zostają nietknięte, bo napisałeś to wprost.
Sprawdź kontrolowaną zmianę kierunku artystycznego
Zachowaj pozę i strój z referencji, a w tym samym poleceniu zmień światło albo otoczenie. Ten endpoint jest dostrojony właśnie do złożonych poleceń, więc nazwij kierunek światła, temperaturę barwową i części, które nie mogą się ruszyć.
Przygotuj spójną serię wariantów
Przypnij seed dla całej serii wariantów, żeby dwie edycje różniły się tylko zmienionym elementem. Każda edycja działa na płótnie 2k, około 4 megapikseli; 4k jest dostępne tylko w trybie tekst na obraz.
Wskazówki
Napisz, co ma zostać, a co może się zmienić
Odwołuj się do źródeł według pozycji — obraz 1, obraz 2 — i napisz zmianę, a po niej listę tego, co ma się nie zmieniać. Przy jednej do dziewięciu referencji nazwij zadanie każdej; ostatnia wyznacza proporcje, gdy pominiesz aspect_ratio.
Utrzymaj poprawkę sprawdzalną po kawałku
Każde żądanie zwraca jeden obraz. Zbuduj serię wariantów, powtarzając wywołanie z przypiętym seedem i resztą bez zmian, zmieniaj po jednym elemencie i porównuj każdy wynik ze źródłem, a nie z poprzednią edycją.
Zweryfikuj wynik zależny od źródła
Każda referencja musi mieć format JPEG, PNG bez przezroczystości, BMP lub WEBP, od 240 do 8000 pikseli na bok, proporcje między 1:8 a 8:1 i nie więcej niż 20 MB. Inne aspect_ratio komponuje kadr od nowa, zamiast go przycinać, więc sprawdź, czy zachowane elementy wciąż są na swoim miejscu.
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/wan-2.7-pro/edit",
"input": {
"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.
