Generator AI obraz na obraz bez cenzury: praktyczny przewodnik po API edycji

Chcesz za pomocą kodu zmienić jedną rzecz na zdjęciu: światło, tło, strój albo napis. Potrzebujesz edytora, który nie odmówi i nie złagodzi po cichu instrukcji. Ten przewodnik wyjaśnia, który endpoint wywołać, ile kosztuje, jakie dane przyjmuje, jak sprawdzić edycję w Playground, a następnie w kodzie lub za pomocą narzędzia Agent, i co zrobić w razie błędu.

Krótka odpowiedź: wywołanie obraz na obraz to zadanie na endpoincie, którego ID modelu kończy się na /edit: wysyłasz prompt i obraz źródłowy, a otrzymujesz zmieniony plik. Dla jednego zdjęcia i jednej instrukcji zacznij od Qwen Image Edit Spicy: 0,038 $ za edycję, jedno źródło, bez maski i regulacji siły. Dla wielu źródeł użyj Qwen Image 3.0, Seedream 5.0 Pro lub Wan 2.7. Do maski wybierz Qwen Image 2.1 albo FLUX.1 Dev LoRA; strength jest dostępne tylko w FLUX.1 Dev LoRA i Z-Image Turbo LoRA.

Poniższe ceny i limity pochodzą z aktualnego katalogu i dokumentacji; każdą cenę ustalono na podstawie bezpłatnej wyceny.

Co oznacza „bez cenzury” w endpoincie edycji

„Bez cenzury” to etykieta katalogowa modelu deklarującego brak filtra treści: SpicyAPI nie dodaje skanowania treści na poziomie platformy, a o wyniku decyduje model. Nie gwarantuje to wykonania każdej instrukcji. Przygotuj się na dwa wyniki:

• Odmowa kończy zadanie jako failed z errorCode: "content_rejected". Cała blokada środków na saldzie zostaje zwolniona.
• Złagodzony wynik to gotowy obraz łagodniejszy od zamówionego. Zadanie jest udane, więc naliczana jest opłata; odpowiedź w żaden sposób tego nie oznacza. Wykryjesz to tylko, oglądając obraz.

Pewne ograniczenia dotyczą wszystkich modeli: zakaz seksualizowanych przedstawień nieletnich w każdym stylu, intymnych lub seksualizowanych przedstawień rozpoznawalnej rzeczywistej osoby bez udokumentowanej zgody (także zamiany twarzy i przeniesienia wyglądu), podszywania się oraz działań nielegalnych tam, gdzie prowadzisz działalność. Drugą zasadę łatwo naruszyć przy edycji, bo źródłem jest często prawdziwe zdjęcie. Według polityki dopuszczalnego użytkowania publiczne zdjęcie, status celebryty ani wcześniejszy związek nie są zgodą. Materiały o niejednoznacznym wieku podlegają zasadzie dotyczącej nieletnich; nie wolno przesyłać prywatnych materiałów bez prawa do ich przetwarzania.

SpicyAPI nie sprawdza każdego żądania. Jeśli użytkownicy przesyłają zdjęcia, obowiązki należą do Ciebie: potwierdzenie wieku, oświadczenie o zgodzie przy przesyłaniu zapisane z ID zadania, odrzucanie źródeł z niejasnym wiekiem osoby, blokowanie edycji rozpoznawalnych rzeczywistych osób bez udokumentowanej zgody oraz możliwość zgłaszania treści. To nie jest porada prawna.

Usługa nie jest dostępna w Chinach kontynentalnych, Rosji, Białorusi, na Kubie, w Iranie, Korei Północnej ani Syrii, a zgodnie z warunkami także w Wielkiej Brytanii, Hongkongu, Makau, Arabii Saudyjskiej, Zjednoczonych Emiratach Arabskich, Katarze, Kuwejcie, Bahrajnie, Omanie, Pakistanie, Bangladeszu, Afganistanie, Indonezji, Malezji i Brunei. Polityka treści i użytkowania przewiduje możliwość rozszerzenia listy. Zamiana twarzy i głowy to osobne endpointy z własnym procesem, opisanym w przepływie pracy API zamiany twarzy AI.

Wybierz endpoint edycji

Endpointy różnią się liczbą źródeł, dodatkowymi ustawieniami i kształtem wyniku:

Ceny są wycenami żądania jednego obrazu. Seedream 5.0 Pro kosztuje dwa razy więcej przy domyślnym 2k niż przy 1k, a Qwen Image 3.0 dolicza opłatę za źródło. Poziomy Qwen Image 2.1 nie drożeją kolejno (1,5k kosztuje więcej niż 2k, a 2k ma stałą cenę niezależnie od źródeł). Przed ustaleniem budżetu wyceń dokładną treść żądania.

Katalog zawiera też inne edytory oznaczone bez cenzury, np. Seedream 5.0 Flash, Qwen Image 3.0 Pro i Wan 2.7 Pro. Endpointy edycji GPT Image 2 i 2.5 oraz Nano Banana mają etykietę Filtered, więc nie są właściwym narzędziem, gdy celem jest wynik bez cenzury.

Jedno zdjęcie, jedna zmiana. Użyj Qwen Image Edit Spicy. Całe żądanie to image_url, prompt i opcjonalne seed; instrukcja jest jedynym sterowaniem, więc zdanie określające, co ma pozostać, jest też ustawieniem zachowania źródła. Jego recenzja podaje około 21 sekund dla typowej edycji. Qwen Image 2 działa podobnie za nieco niższą cenę, z jednym źródłem i limitem 800 znaków promptu.

Kilka źródeł w jednej edycji. Twarz z jednego zdjęcia, ubranie z drugiego, pokój z trzeciego: Qwen Image 3.0 (trzy źródła), Seedream 5.0 Pro (dziesięć) lub Wan 2.7 (dziewięć). Prompt musi określać, co dostarcza każdy obraz. Seedream 5.0 Pro domyślnie trzyma się kształtu pierwszego źródła, Wan 2.7 ostatniego, a Qwen tworzy kwadrat: portret przesłany do Qwen Image 3.0 bez aspect_ratio wróci jako 1:1.

Edycja lokalna z maską lub regulacją siły. Qwen Image 2.1 i FLUX.1 Dev LoRA przyjmują maskę jako mask_url: czarno-biały obraz o rozmiarze źródła, gdzie biel jest przemalowywana, a czerń zachowana. strength (0–1, domyślnie 0,8, stopień odejścia od źródła) istnieje w FLUX.1 Dev LoRA i endpoincie edycji Z-Image Turbo LoRA. Wan 2.7 inaczej oznacza obszary: do dwóch prostokątów w pikselach na obraz w bounding_boxes.

Wyniki dotyczące treści. Według publicznych raportów z września 2026 każdy edytor przeszedł pięć poziomów treści (L1 najłagodniejszy, L5 najmocniejszy), zwykle po trzy uruchomienia na poziom.

FLUX.1 Dev LoRA to najtańsza opcja z maską i strength, ale publiczny raport dotyczy tekstu na obraz, gdzie mocniejsze poziomy zostały złagodzone. Przetestuj więc własny poziom treści w jednej edycji, zanim się zdecydujesz.

Szczegóły znajdziesz w recenzjach modeli, np. Seedream 5.0 Pro; test Qwen Image Edit bez cenzury pokazuje pary przed i po edycji w modelach Qwen.

Lokalnie czy w usłudze hostowanej? Przy GPU z co najmniej 8 GB VRAM i dużej liczbie edycji lokalny model w ComfyUI (Qwen Image Edit lub FLUX.2 Klein) jest realną opcją. Hosting ma sens, jeśli nie chcesz obsługiwać GPU, potrzebujesz wywołań z aplikacji albo płatności za obraz: przy 0,018 $–0,072 $ za obraz sto edycji kosztuje 1,80 $–7,20 $ przed ponownymi próbami.

Najpierw wypróbuj Playground

Najszybciej sprawdzisz działanie edytora na zdjęciu w Playground na stronie modelu, bez kodu i zarządzania kluczami.

1. Otwórz stronę Qwen Image Edit Spicy, pozostań na karcie Playground, w widoku Form. Aby uruchomić, zaloguj się na konto z saldem.
2. W Input image upuść plik (JPG, PNG, WEBP lub GIF, do 10 MB) albo użyj Asset URL i Add URL dla bezpośredniego linku do pliku.
3. W Prompt podaj, co ma pozostać, a potem jedną zmianę (przykłady sformułowań są w następnej sekcji).
4. Opcjonalnie ustaw Seed. Ten sam seed przy tym samym obrazie i instrukcji pozwala porównać dwa sformułowania.
5. Naciśnij Run model i najpierw obejrzyj obraz w Output: złagodzony wynik jest płatny jak każdy inny.

Inne edytory mają w tym samym formularzu własne pola, np. dodatkowe źródła lub maskę w Qwen Image 2.1. Widok JSON obok Form pokazuje dokładną treść żądania, a sąsiednie karty kodu (JavaScript, Python, cURL i inne) to samo wywołanie. Działającą tu konfigurację możesz skopiować do projektu.

Następnie uruchom z kodu

Zainstaluj Python SDK (pip install spicyapi), ustaw SPICY_API_KEY w środowisku i wykonaj jedną edycję. Skrypt przesyła zdjęcie, pokazuje cenę i czeka na zgodę przed utworzeniem zadania:

import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment
MODEL = "alibaba/qwen-image-spicy-edit/edit"

source = client.upload_file("photo.jpg")  # or put a public HTTPS link in image_url
body = {
    "image_url": source["uri"],
    "prompt": "Keep the person, pose, framing and room exactly as they are. "
              "Change only the light to warm late-afternoon sun from the window on the left.",
}

quote = client.quote_task(model=MODEL, input_data=body)
print("Estimated", quote["estimatedCost"], "maximum", quote["maxCharge"])
if input("Create the task? [y/N] ").strip().lower() != "y":
    raise SystemExit

task = client.create_task(
    model=MODEL,
    input_data=body,
    idempotency_key=str(uuid.uuid4()),
    quote_id=quote["quoteId"],
    expected_cost=quote["estimatedCost"],
)
print("Resume task:", task["taskId"], flush=True)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
    raise SystemExit(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
assets = output_assets(final)
if not assets or any(a.get("pending") or a.get("unavailable") or not a.get("url") for a in assets):
    raise RuntimeError(f"Task {task['taskId']} has no ready output; check this task before a new run")
print(assets[0]["url"])  # copy the image to your own storage now

Dokumentacja Python SDK i przewodnik po zadaniach opisują resztę; usługa, która zamiast czekać ma otrzymać wywołanie zwrotne, może korzystać z webhooków.

Albo zleć wykonanie narzędziu Agent

Jeśli edycje ma wykonywać asystent, wszystkie trzy oficjalne narzędzia pokazują cenę i pytają przed płatnym wywołaniem.

• CLI. Prześlij zdjęcie, wpisz zwrócony adres spicy:// i prompt do input.json jako image_url i prompt, a następnie:

``bash spicyapi files upload photo.jpg spicyapi tasks create --model alibaba/qwen-image-spicy-edit/edit --input-file input.json --wait ``

Zobacz dokumentację CLI; npx @spicyapi/cli działa bez instalacji.

• Serwer MCP. Dodaj serwer MCP do asystenta, a potem poproś: "Edit /path/to/photo.jpg with Qwen Image Edit Spicy: keep the person, pose and room, change only the light to warm late-afternoon sun." Przesyła plik przez spicyapi_upload_file, wywołuje spicyapi_task_create, zatrzymujące się na potwierdzenie ceny, a potem spicyapi_task_wait.
• Skill. npx skills add spicyapi-ai/spicy-skill instaluje Agent Skill, dzięki któremu asystent programistyczny czyta aktualny schemat modelu zamiast zgadywać pola.

Co możesz wysłać i ile to kosztuje

Obraz źródłowy można przekazać na trzy sposoby:

• Publiczny URL HTTPS, bez przesyłania pliku. Musi zwracać sam plik obrazu bez uwierzytelniania; udostępniona strona dysku lub albumu jest stroną internetową i zostaje odrzucona kodem 400.
• Mały obraz osadzony, zapisany jako data:image/png;base64,... w tym samym polu. Musi to być JPEG, PNG, WebP lub GIF, maksymalnie 1 MiB po dekodowaniu i 8192 piksele na bok.
• Przesłanie pliku, gdy jest większy lub prywatny: JPEG, PNG, WebP lub GIF do 10 MiB. Przesyłanie jest bezpłatne; płacisz tylko za zadanie korzystające z pliku. Otrzymujesz URI spicy:// ważne przez jeden dzień.

Qwen Image 2 przyjmuje tylko JPEG, PNG i WebP. Pola różnią się: Qwen Image Edit Spicy i FLUX.1 Dev LoRA przyjmują jeden ciąg image_url, pozostałe tablicę image_urls. Endpoint odrzuca niewymienione pole, zamiast je ignorować.

Koszt zależy od poziomu rozdzielczości, liczby źródeł, a w Wan 2.7 od num_outputs; cena przed potwierdzeniem odpowiada dokładnemu żądaniu. Zobacz wyceny i przewodnik po mediach.

Inne endpointy: zmieniają się tylko dane wejściowe

Modele przyjmujące tablicę używają image_urls, a przy wielu źródłach prompt określa ich role. Użyj tego samego kodu z poniższym ID modelu i treścią:

{
  "model": "alibaba/qwen-image-3.0/edit",
  "input": {
    "prompt": "Use the person from the first image and the jacket from the second. Keep her face, hair and pose from the first image. Change nothing else.",
    "image_urls": ["spicy://f/fil_...", "spicy://f/fil_..."],
    "aspect_ratio": "3:4",
    "resolution": "2k"
  }
}

Edycja z maską w FLUX.1 Dev LoRA dodaje maskę i siłę do żądania z jednym źródłem:

{
  "model": "black-forest-labs/flux-1-dev-lora/edit",
  "input": {
    "prompt": "A black satin jacket with a high collar, same light as the rest of the photo.",
    "image_url": "spicy://f/fil_...",
    "mask_url": "spicy://f/fil_...",
    "strength": 0.9,
    "seed": 7
  }
}

Niższe strength daje wynik bliższy oryginałowi; domyślna wartość to 0,8. Kopiuj wartości z aktualnego schematu na stronie modelu; przewodnik po generowaniu obrazów wyjaśnia różnice między endpointami.

Napisz instrukcję: najpierw co zostaje, potem co się zmienia

Endpoint edycji przerysowuje to, czego nie określisz. Najpierw podaj, co ma pozostać identyczne, potem jedną zmianę. Wymienienie większej liczby zachowywanych elementów nie kosztuje więcej. W Qwen Image 3.0 i 2.1 ustaw enable_prompt_expansion na false, aby uzyskać wierną edycję. Domyślnie funkcja jest włączona i rozbudowuje prompt do opisu sceny, co może osłabić zdanie o zachowaniu źródła.

• Tylko światło: “Keep the person, pose, framing and room exactly as they are. Change only the light to warm late-afternoon sun from the window on the left. Keep the colour grade and film grain.”
• Tylko tło: “Keep the subject, outfit and crop. Replace the studio wall with dark theatre curtains. Add no logos or text.”
• Wiele źródeł: “Use the person from the first image, the jacket from the second and the street from the third. Keep her face and pose from the first image. Change nothing else.”

Zmieniaj jedną rzecz na przebieg; łączenie zmian stylu i tekstu sprzyja dryfowi tożsamości. Gdy wynik nie trafia w cel:

Gdy edycja się nie uda

To błędy właściwe edycji; rozgałęziaj logikę według numerycznego code lub errorCode zadania, nie tekstu komunikatu.

Błędy salda, limitu czasu i inne ogólne są w dokumentacji błędów.

Co dzieje się z plikami

Przesłane zdjęcia pozostają jeden dzień, a wyniki do 14 dni. Gdy zadanie się powiedzie, od razu skopiuj potrzebny wynik do własnego magazynu. Jeśli zdjęcie ma pozostać krócej, dokumentacja retencji opisuje skrócenie okna lub zniszczenie mediów i promptu zakończonego zadania. Zobacz też tymczasowe przesyłanie i trwałe dostarczanie mediów oraz przewodnik startowy po API obrazów i wideo.

Częste pytania

Czy jest API obraz na obraz bez cenzury z regulacją siły?

Tak: FLUX.1 Dev LoRA (strength od 0 do 1, domyślnie 0,8, z opcjonalną maską) i endpoint edycji Z-Image Turbo LoRA. W pozostałych sterowaniem jest instrukcja, a wysłanie strength zwraca 400 strength: is not a supported field.

Czy muszę przesłać zdjęcie?

Nie. Działa publiczny link HTTPS albo obraz osadzony do 1 MiB; prześlij plik, gdy jest większy lub prywatny.

Czy odmowa lub nieudana edycja kosztuje?

Zwykle nie: nieudane zadanie zwalnia całą blokadę, a błąd utworzenia nie nalicza opłaty. Złagodzony wynik jest gotowym obrazem i jest płatny.

Czy edycja zachowa twarz i pozę?

Nie ma gwarancji. Wskaż, co pozostaje, zmieniaj jedną rzecz na przebieg i używaj jednego źródła, gdy możesz. Seedream 5.0 Pro zachował osobę przy zmianie światła i stroju, lecz mniej dokładnie umieszczał twarz podczas wstawiania osoby do nowej scenografii z drugiego zdjęcia. Qwen Image 2 dobrze wykonywał proste edycje, ale przebudowywał część mebli przy złożonych edycjach.

Czy mogę edytować zdjęcie rzeczywistej osoby?

Tylko za jej udokumentowaną zgodą; bez niej nigdy w formie seksualizowanej. Dotyczy to wszystkich modeli; zachowaj dowód zgody we własnym systemie.

Od którego endpointu zacząć?

Qwen Image Edit Spicy dla jednego zdjęcia i jednej zmiany. Przejdź do innego dopiero wtedy, gdy potrzebujesz kilku źródeł, maski lub strength. Najpierw wykonaj edycję i obejrzyj obraz, zanim zmienisz endpoint.

Co dalej

Wykonaj jedną edycję w Playground na nieszkodliwym zdjęciu testowym i przeczytaj cenę przed potwierdzeniem. Następnie wybierz płatny poziom rozdzielczości i zdecyduj, czy produkcja powinna używać webhooka zamiast czekania.

Szczegółowe wskazówki dotyczące promptów Spicy znajdziesz w przepływie zachowania źródła Qwen Image Edit Spicy. Aby porównać edytory istniejących obrazów także poza API, zobacz najlepsze edytory obrazów AI bez cenzury. Katalog API obrazów bez cenzury wymienia wszystkie dostępne modele z etykietą treści i aktualną ceną.