Unzensierter KI-Image-to-Image-Generator: praktischer Leitfaden zur Bildbearbeitungs-API

Sie möchten per Code genau eine Sache in einem Foto ändern: Licht, Hintergrund, Kleidung oder einen Schriftzug. Der Editor soll die Anweisung weder ablehnen noch unbemerkt abschwächen. Dieser Leitfaden erklärt, welchen Bearbeitungsendpunkt Sie aufrufen, was er kostet und akzeptiert, wie Sie ihn im Playground und danach per Code oder Agent ausprobieren und was bei Fehlern zu tun ist.

Kurz gesagt: Ein Image-to-Image-Aufruf ist ein Task an einem Endpunkt, dessen Modell-ID auf /edit endet: Sie senden einen Prompt und ein Quellbild und erhalten die bearbeitete Datei. Für ein Foto und eine Anweisung beginnen Sie mit Qwen Image Edit Spicy: $0.038 pro Bearbeitung, eine Quelle, keine Maske, kein Stärkeregler. Für mehrere Quellen verwenden Sie Qwen Image 3.0, Seedream 5.0 Pro oder Wan 2.7. Für eine Maske wählen Sie Qwen Image 2.1 oder FLUX.1 Dev LoRA; strength gibt es nur bei FLUX.1 Dev LoRA und Z-Image Turbo LoRA.

Die folgenden Preise und Grenzen stammen aus dem Live-Katalog und der Dokumentation; für jede Preisangabe wurde ein kostenloses Angebot eingeholt.

Was „unzensiert“ bei einem Bearbeitungsendpunkt bedeutet

„Unzensiert“ bezeichnet im Katalog ein Modell, das laut eigener Angabe keinen Inhaltsfilter hat: SpicyAPI ergänzt keine plattformseitige Inhaltsprüfung; das Modell entscheidet über die Ausgabe. Das verspricht keine Umsetzung jeder Anweisung. Rechnen Sie mit zwei Ergebnissen:

• Eine Ablehnung beendet den Task als failed mit errorCode: "content_rejected". Die Reservierung Ihres Guthabens wird vollständig freigegeben.
• Ein abgeschwächtes Ergebnis ist ein fertiges Bild, das milder ausfällt als angefordert. Der Task ist erfolgreich und wird berechnet; die Antwort kennzeichnet das nicht. Sie erkennen es nur beim Betrachten des Bildes.

Einige Grenzen gelten für jedes Modell: keine sexualisierte Darstellung Minderjähriger in irgendeinem Stil, keine intime oder sexualisierte Darstellung identifizierbarer realer Personen ohne dokumentierte Einwilligung (einschließlich Gesichtstausch und Übertragung des Aussehens), keine Identitätstäuschung und nichts, was an Ihrem Betriebsort rechtswidrig ist. Bei Bearbeitungsendpunkten lässt sich die zweite Regel leicht verletzen, weil die Quelle oft ein echtes Foto ist. Laut Richtlinie zur zulässigen Nutzung sind ein öffentliches Foto, Bekanntheit oder eine frühere Beziehung keine Einwilligung. Material mit unklarem Alter fällt unter die Minderjährigenregel; private Inhalte dürfen Sie ohne Verarbeitungsrecht nicht hochladen.

SpicyAPI prüft nicht jeden einzelnen Aufruf. Wenn Ihre Nutzer Fotos hochladen, liegen die Pflichten daher bei Ihnen: Altersverifikation, eine beim Upload abgegebene und mit der Task-ID gespeicherte Einwilligungserklärung, Ablehnung von Quellen mit unklarem Alter, Sperre von Bearbeitungen identifizierbarer realer Personen ohne dokumentierte Einwilligung sowie eine Meldemöglichkeit für Nutzer. Dies ist keine Rechtsberatung.

Der Dienst ist in Festlandchina, Russland, Belarus, Kuba, Iran, Nordkorea und Syrien nicht verfügbar, laut Nutzungsbedingungen ebenso wenig im Vereinigten Königreich, Hongkong, Macau, Saudi-Arabien, den Vereinigten Arabischen Emiraten, Katar, Kuwait, Bahrain, Oman, Pakistan, Bangladesch, Afghanistan, Indonesien, Malaysia und Brunei. Laut Inhalts- und Nutzungsrichtlinie kann die Liste erweitert werden. Gesichts- und Kopftausch sind eigene Endpunkte mit einem separaten Ablauf, beschrieben im Workflow für die KI-Gesichtstausch-API.

Den Bearbeitungsendpunkt wählen

Endpunkte unterscheiden sich in der Zahl der Quellen, zusätzlichen Steuerelementen und der Form des Ergebnisses:

Die Preise sind Angebotsbeträge für einen Aufruf mit einem Bild. Seedream 5.0 Pro kostet in der standardmäßigen 2k-Stufe doppelt so viel wie bei 1k; Qwen Image 3.0 berechnet einen Zuschlag je Quelle. Die Stufen von Qwen Image 2.1 steigen nicht der Reihe nach (1.5k liegt über 2k, und bei 2k bleibt der Betrag unabhängig von den Quellen gleich). Holen Sie vor der Budgetplanung ein Angebot für den genauen Anfrageinhalt ein.

Der Katalog enthält weitere als unzensiert gekennzeichnete Editoren, etwa Seedream 5.0 Flash, Qwen Image 3.0 Pro und Wan 2.7 Pro. Die Bearbeitungsendpunkte von GPT Image 2 und 2.5 sowie Nano Banana tragen die Kennzeichnung Filtered und sind daher ungeeignet, wenn ein unzensiertes Ergebnis das Ziel ist.

Ein Foto, eine Änderung. Verwenden Sie Qwen Image Edit Spicy. Die gesamte Anfrage besteht aus image_url, prompt und einem optionalen seed. Die Anweisung ist die einzige Steuerung; ein Satz darüber, was bleiben muss, ist zugleich Ihre Einstellung zum Erhalt der Vorlage. Laut Testbericht dauert eine typische Bearbeitung etwa 21 Sekunden. Qwen Image 2 folgt demselben Prinzip, etwas günstiger, mit einer Quelle und maximal 800 Prompt-Zeichen.

Mehrere Quellen in einer Bearbeitung. Ein Gesicht aus einem Foto, ein Kleidungsstück aus einem anderen, ein Raum aus einem dritten: Qwen Image 3.0 (drei Quellen), Seedream 5.0 Pro (zehn) oder Wan 2.7 (neun). Bei mehreren Quellen muss der Prompt festlegen, welches Bild was liefert. Seedream 5.0 Pro orientiert sich standardmäßig am Format der ersten, Wan 2.7 an dem der letzten Quelle; Qwen-Endpunkte liefern standardmäßig ein Quadrat. Ein Porträt ohne aspect_ratio an Qwen Image 3.0 kommt als 1:1 zurück.

Lokale Änderungen mit Maske oder Stärkeregler. Qwen Image 2.1 und FLUX.1 Dev LoRA akzeptieren eine Maske als mask_url: ein Schwarz-Weiß-Bild in Quellgröße, bei dem Weiß neu gezeichnet und Schwarz erhalten wird. strength (0 bis 1, Standard 0.8; Abstand des Ergebnisses zur Quelle) gibt es bei FLUX.1 Dev LoRA und dem Bearbeitungsendpunkt von Z-Image Turbo LoRA. Wan 2.7 markiert Bereiche anders: bis zu zwei Pixelrechtecke je Bild in bounding_boxes.

Inhaltsergebnisse. In unseren öffentlichen Testberichten vom September 2026 durchlief jeder Editor fünf Inhaltsstufen (L1 am mildesten, L5 am stärksten), meist mit drei Durchläufen pro Stufe.

FLUX.1 Dev LoRA ist die günstigste Route mit Maske und strength. Sein öffentlicher Bericht behandelt aber Text-zu-Bild, wo stärkere Stufen abgeschwächt ausfielen. Testen Sie deshalb Ihre Inhaltsstufe mit einer einzelnen Bearbeitung, bevor Sie sich festlegen.

Details finden Sie auf den Testseiten, etwa bei Seedream 5.0 Pro. Der unzensierte Qwen-Image-Edit-Test zeigt Vorher-Nachher-Paare der Qwen-Editoren.

Lokal oder gehostet? Mit einer GPU mit mindestens 8 GB VRAM und vielen Bearbeitungen ist ein lokales Modell in ComfyUI (Qwen Image Edit oder FLUX.2 Klein) eine echte Option. Hosting eignet sich, wenn Sie keine GPU betreiben, einen Editor aus einer App aufrufen oder pro Bild bezahlen möchten: Bei $0.018 bis $0.072 pro Bild kosten hundert Bearbeitungen $1.80 bis $7.20 vor Wiederholungen.

Zuerst im Playground ausprobieren

Am schnellsten sehen Sie im Playground der Modellseite, was ein Editor mit Ihrem Foto macht, ohne Code oder Schlüsselverwaltung.

1. Öffnen Sie die Qwen Image Edit Spicy-Seite, bleiben Sie im Tab Playground und in der Ansicht Form. Melden Sie sich mit einem Konto mit Guthaben an.
2. Ziehen Sie unter Input image eine Datei hinein (JPG, PNG, WEBP oder GIF, bis 10 MB), oder verwenden Sie Asset URL und Add URL für einen direkten Bilddateilink.
3. Beschreiben Sie unter Prompt zuerst, was bleiben muss, dann die eine Änderung (Formulierungen folgen im nächsten Abschnitt).
4. Legen Sie optional einen Seed fest. Derselbe Wert bei gleichem Bild und gleicher Anweisung macht zwei Formulierungen vergleichbar.
5. Drücken Sie Run model und betrachten Sie zuerst das Bild unter Output: Ein abgeschwächtes Ergebnis wird wie jedes andere berechnet.

Andere Editoren haben eigene Formularfelder, etwa weitere Quellbilder oder eine Maske bei Qwen Image 2.1. Die Ansicht JSON neben Form zeigt den genauen Anfrageinhalt; die danebenliegenden Code-Tabs (JavaScript, Python, cURL und weitere) zeigen denselben Aufruf. Eine hier funktionierende Konfiguration können Sie in Ihr Projekt übernehmen.

Danach per Code ausführen

Installieren Sie das Python SDK (pip install spicyapi), setzen Sie SPICY_API_KEY in Ihrer Umgebung und führen Sie eine Bearbeitung aus. Das Skript lädt das Foto hoch, zeigt den Preis und wartet vor der Task-Erstellung auf Ihre Zustimmung:

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

Die Python-SDK-Referenz und der Task-Leitfaden behandeln alles über diesen Aufruf hinaus. Ein Dienst, der statt zu warten einen Rückruf erhalten soll, kann Webhooks verwenden.

Oder einen Agent ausführen lassen

Soll ein Assistent die Bearbeitungen ausführen, zeigen alle drei offiziellen Werkzeuge den Preis und fragen vor einem kostenpflichtigen Aufruf nach.

• CLI. Laden Sie das Foto hoch und tragen Sie die zurückgegebene spicy://-Adresse und Ihren Prompt in input.json als image_url und prompt ein. Danach:

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

Siehe CLI-Dokumentation; npx @spicyapi/cli funktioniert ohne Installation.

• MCP-Server. Fügen Sie Ihrem Assistenten den MCP-Server hinzu und bitten Sie ihn: "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." Er lädt die Datei mit spicyapi_upload_file hoch, ruft spicyapi_task_create auf, das für Ihre Preisbestätigung anhält, und danach spicyapi_task_wait.
• Skill. npx skills add spicyapi-ai/spicy-skill installiert den Agent Skill. Damit liest ein Coding-Assistent das aktuelle Modellschema, statt Felder zu erraten.

Was Sie senden können und was es kostet

Ein Quellbild kann den Task auf drei Wegen erreichen:

• Eine öffentliche HTTPS-URL, ohne Upload. Sie muss ohne Zugangsdaten direkt die Bilddatei liefern. Eine Cloud-Speicher- oder Album-Freigabeseite ist eine Webseite und wird mit 400 abgelehnt.
• Ein kleines eingebettetes Bild, im selben Feld als data:image/png;base64,.... Zulässig sind JPEG, PNG, WebP und GIF, dekodiert höchstens 1 MiB und 8192 Pixel pro Seite.
• Ein Upload für größere oder private Dateien: JPEG, PNG, WebP oder GIF bis 10 MiB. Der Upload ist kostenlos; Sie bezahlen nur den Task, der die Datei nutzt. Zurück kommt eine spicy://-URI, die einen Tag gültig ist.

Qwen Image 2 akzeptiert nur JPEG, PNG und WebP. Die Felder unterscheiden sich: Qwen Image Edit Spicy und FLUX.1 Dev LoRA verwenden eine einzelne image_url-Zeichenfolge, die anderen ein image_urls-Array. Ein Endpunkt lehnt nicht aufgeführte Felder ab, statt sie zu ignorieren.

Die Kosten hängen von Auflösungsstufe, Quellenzahl und bei Wan 2.7 von num_outputs ab. Der vor Ihrer Bestätigung angezeigte Preis gilt für Ihre genaue Anfrage. Siehe Preisangebote und Medienleitfaden.

Andere Endpunkte: Nur die Eingabe ändert sich

Modelle mit Arrays verwenden image_urls; bei mehreren Quellen weist der Prompt die Rollen zu. Nutzen Sie denselben Code mit der folgenden Modell-ID und dem folgenden Anfrageinhalt:

{
  "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"
  }
}

Eine maskierte Bearbeitung mit FLUX.1 Dev LoRA ergänzt die Einzelquellen-Anfrage um Maske und Stärke:

{
  "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
  }
}

Ein niedrigeres strength bleibt näher am Original; der Standard ist 0.8. Übernehmen Sie Feldwerte aus dem aktuellen Schema der jeweiligen Modellseite. Der Leitfaden zur Bilderzeugung erklärt die Unterschiede zwischen Bildendpunkten.

Die Anweisung schreiben: Zuerst festlegen, was bleibt, dann die Änderung

Ein Bearbeitungsendpunkt zeichnet neu, was Sie nicht festlegen. Nennen Sie zuerst, was identisch bleiben soll, und danach die eine Änderung. Mehr zu erhaltende Elemente zu nennen kostet nichts extra. Setzen Sie bei Qwen Image 3.0 und 2.1 enable_prompt_expansion auf false, um die Anweisung getreu umzusetzen. Die Funktion ist standardmäßig an und erweitert den Prompt zu einer ausführlicheren Szenenbeschreibung, die den Erhaltungssatz abschwächen kann.

• Nur Licht: “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.”
• Nur Hintergrund: “Keep the subject, outfit and crop. Replace the studio wall with dark theatre curtains. Add no logos or text.”
• Mehrere Quellen: “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.”

Ändern Sie eine Sache pro Durchlauf; kombinierte Änderungen von Stil und Text führen eher zu Identitätsdrift. Falls das Ergebnis danebenliegt:

Wenn es fehlschlägt

Dies sind bearbeitungsspezifische Fehler. Verzweigen Sie anhand des numerischen code oder des errorCode des Tasks, nicht anhand des Meldungstexts.

Guthaben-, Timeout- und andere allgemeine Fehler stehen in der Fehlerreferenz.

Was mit den Dateien passiert

Hochgeladene Fotos bleiben einen Tag, Ergebnisse bis zu 14 Tage. Kopieren Sie ein aufzubewahrendes Ergebnis daher sofort nach erfolgreichem Task in Ihren eigenen Speicher. Soll ein Foto kürzer auf der Plattform bleiben, erklärt die Aufbewahrungsdokumentation, wie Sie das Zeitfenster verkürzen oder Medien und Prompt eines abgeschlossenen Tasks vernichten. Siehe auch temporäre Uploads und dauerhafte Medienauslieferung sowie den Einsteigerleitfaden zur Bild- und Video-API.

Häufige Fragen

Gibt es eine unzensierte Image-to-Image-API mit Stärkeregler?

Ja: FLUX.1 Dev LoRA (strength 0 bis 1, Standard 0.8, mit optionaler Maske) und der Bearbeitungsendpunkt von Z-Image Turbo LoRA. Bei den anderen steuert die Anweisung die Bearbeitung; strength führt zu 400 strength: is not a supported field.

Muss ich das Foto hochladen?

Nein. Ein öffentlicher HTTPS-Link oder ein eingebettetes Bild bis 1 MiB genügt. Laden Sie größere oder private Dateien hoch.

Kostet eine abgelehnte oder fehlgeschlagene Bearbeitung Geld?

Normalerweise nicht: Ein fehlgeschlagener Task gibt die gesamte Reservierung frei, ein Fehler bei der Erstellung kostet nichts. Ein abgeschwächtes Ergebnis ist ein fertiges Bild und wird berechnet.

Bleiben Gesicht und Pose erhalten?

Das ist nicht garantiert. Benennen Sie, was bleibt, ändern Sie eine Sache pro Durchlauf und verwenden Sie möglichst eine Quelle. Seedream 5.0 Pro erhielt die Person bei Licht- und Kleidungswechseln, platzierte das Gesicht aber weniger genau, wenn sie mit einer zweiten Aufnahme in eine neue Kulisse eingefügt wurde. Qwen Image 2 erledigte einfache Änderungen sauber, baute bei komplexen aber teils Möbel um.

Darf ich das Foto einer realen Person bearbeiten?

Nur mit dokumentierter Einwilligung dieser Person, und ohne sie niemals sexualisiert. Das gilt für jedes Modell; bewahren Sie den Einwilligungsnachweis in Ihrem eigenen System auf.

Mit welchem Endpunkt sollte ich beginnen?

Qwen Image Edit Spicy für ein Foto und eine Änderung. Wechseln Sie erst, wenn Sie mehrere Quellen, eine Maske oder strength benötigen. Führen Sie zuerst eine Bearbeitung aus und betrachten Sie das Bild, bevor Sie den Endpunkt wechseln.

Wie es weitergeht

Führen Sie im Playground eine Bearbeitung mit einem unbedenklichen Testfoto aus und lesen Sie vor der Bestätigung den Preis. Wählen Sie danach Ihre Auflösungsstufe und entscheiden Sie, ob die Produktion einen Webhook statt Warteaufrufen verwenden soll.

Ausführliche Prompt-Hinweise für den Spicy-Editor enthält der Qwen-Image-Edit-Spicy-Workflow zum Erhalt der Quelle. Ein Vergleich für vorhandene Bilder über die API hinaus findet sich unter beste unzensierte KI-Bildeditoren. Der Katalog unzensierter Bild-APIs listet jedes aufrufbare Bildmodell mit Inhaltskennzeichnung und Live-Preis.