Wprowadzenie
Qwen Image Edit Spicy edytuje jeden obraz źródłowy według jednego polecenia prostym angielskim. Nie ma maski, zaznaczania obszaru ani suwaka odejścia od oryginału — zdanie jest całym sterowaniem, a chronione jest tylko to, co nazwiesz.
Żądanie to image_url, prompt i opcjonalny seed; seed równy 0 oznacza losowe losowanie. Każde żądanie zwraca jeden obraz.
Najważniejsze funkcje
Bez maski, bez siły, bez procedury inpaintingu
Większość edytorów każe wybrać obszar i stopień zmiany, zanim cokolwiek się zmieni. Ten przyjmuje zdanie. Nazwij, co się zmienia, nazwij, co ma zostać, i wyślij. Brak suwaka siły jest celowy: to, co zachowujesz, wyrażasz słowami, i tak też później sprawdzisz edycję.
Odważne zmiany stroju, niefiltrowane
Zmiana stroju, której odmawiają filtrowane edytory, jest tutaj zwykłym poleceniem, a nie szczególnym przypadkiem. Nie ma flagi dojrzałości do ustawienia ani innego endpointu, na który żądanie zostałoby przekierowane. Dosadne sformułowania w poleceniu trafiają dalej tak, jak zostały napisane.
Zmień napis na szyldzie bez przerysowywania pokoju
Ponieważ model dziedziczy typografię linii Qwen Image, potrafi zmienić tekst, który już jest na obrazie — zawieszkę na drzwi, tablicę z menu, etykietę butelki. Przytocz obecny ciąg i ten, który chcesz, i zaznacz, że poza, kadr i gradacja kolorów zostają nietknięte.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
image_url | Tak | Publiczny, bezpośrednio pobieralny link do obrazu, do którego masz prawa. Strony podglądu i krótko żyjące podpisane adresy zawodzą; źródło wyznacza też sufit szczegółowości wyniku. od 1 znaków |
prompt | Tak | Jedna instrukcja niosąca obie połowy edycji. od 1 znaków |
seed | Nie | Podaj ten sam seed przy tym samym obrazie i tej samej instrukcji, żeby rysunek pozostał identyczny między dwiema edycjami i jedyną różnicą było to, co zmieniłeś; to narzędzie do… |
Cennik
$0.038 / obraz
Zastosowania
Dopracuj dostarczony obraz
Używaj tego endpointu, gdy istniejące zdjęcie ma pozostać tym zdjęciem, a zmienić ma się tylko jedna rzecz. Wyślij je jako image_url, nazwij zmianę i elementy, które mają zostać — pozę, kadr, światło, gradację kolorów — i porównaj wynik ze źródłem.
Polecenia, które inne edytory odrzucają
Odważne polecenia dotyczące stroju, które odrzucają filtrowane API do edycji, działają tu jako zwykłe edycje. W żądaniu nic się nie zmienia: te same nazwy pól, ten sam cykl życia zadania, to samo asynchroniczne odpytywanie o wynik.
Zmiany stroju na zatwierdzonym kadrze
Masz już portret, w którym poza i światło działają. Zamień strój na wieczorowy lub odważniejszy look bez ponownego generowania sceny, tak aby twarz, pomieszczenie i gradacja przetrwały zmianę, a zestaw pozostał spójny.
Warianty tekstu na zdjęciu, za które już zapłaciłeś
Zmień tylko słowa na szyldzie, zawieszce albo etykiecie, a fotografię zostaw identyczną. Taniej i znacznie spójniej niż generowanie całej sceny od nowa dla każdego języka czy każdego hasła kampanii.
Wskazówki
Umieść obraz źródłowy tam, skąd da się go pobrać
image_url musi być publicznym linkiem do bezpośredniego pobrania — nie stroną przeglądarki obrazów i nie podpisanym URL-em, który wygaśnie, zanim zadanie ruszy. Źródło wyznacza kompozycję i sufit jakości całego przebiegu.
Napisz jedno polecenie, które nazywa obie strony edycji
Napisz, co się zmienia i co ma zostać identyczne, po jednym zdaniu na każdą rzecz. Edycja dla tego endpointu powstała z polecenia: „Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.”
Dostosuj dołączony przykład
Zacznij od opublikowanego przykładu, z publicznie dostępnym URL-em w image_url. Wymień obiekt i kierunek kreatywny, ale zachowaj kontrakt wejścia tego trybu.
Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.
Dokładne polecenie stojące za edycją pokazaną dla tego endpointu: zmiana stroju i zmiana tekstu na zawieszce na drzwi, przy czym poza, kadr, światło i gradacja są wyraźnie wskazane jako niezmienione. Dostarcz własny kadr źródłowy — image_url w przykładzie to symbol zastępczy, nie hostowana próbka.
Sprawdź wynik, zanim zaczniesz iterować
Pewna droga to jedna zmiana na wywołanie z wprost nazwanymi elementami do zachowania — pozą, kadrem, światłem, gradacją kolorów. Poproś o zmianę stroju i zmianę tekstu w jednym poleceniu, a jedno z nich zwykle się rozjedzie. Tożsamość dobrze trzyma się przy pojedynczej, precyzyjnej edycji i słabnie w długich łańcuchach, więc wracaj do oryginału, a nie do poprzedniego wyniku. Nie ma suwaka siły: jeśli edycja poszła za daleko, pomaga dokładniejsze zdanie, a nie niższa liczba.
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-spicy-edit/edit",
"input": {
"image_url": "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.
