Einführung
Z-Image Base LoRA Bild-zu-Bild zeichnet ein Vorlagenbild auf Z-Image neu, dem Basismodell mit 6 Milliarden Parametern vom Tongyi-MAI-Team von Alibaba, und lädt dabei bis zu drei Ihrer eigenen LoRA-Dateien. Ein Stärkeregler legt fest, wie weit sich das Ergebnis von der Vorlage entfernt. Die Ausgabe behält das Seitenverhältnis der Vorlage. Die Plattform legt keinen Content-Filter über Prompt, Gewichte oder Bild.
Modus nach dem Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| eine geschriebene Beschreibung | Z-Image Base LoRA Text-zu-Bild |
| ein Bild, das umgestaltet werden soll | Z-Image Base LoRA Bild-zu-Bild |
Wichtige Funktionen und Highlights
Mit einer LoRA umgestalten, die Komposition behalten
Mit einer Stil-LoRA bei Stärke 0,6 wurden unsere Testfotos als Illustrationen neu gezeichnet, während Pose, Ausschnitt und Kleidung exakt an ihrem Platz blieben.
Ein Stärkeregler
Die Stärke reicht von 0 bis 1 (Standard 0,7). Unter 0,6 kommt die Vorlage fast unverändert zurück; ab etwa 0,75 wird die Szene mit demselben Licht und derselben Palette neu posiert und neu inszeniert.
Zwei Auflösungsstufen
1k liefert eine lange Seite von 1.024 Pixeln, 1.5k eine von 1.536 Pixeln, jeweils im eigenen Seitenverhältnis der Vorlage. Beide kosten gleich viel.
Kein Content-Filter
Ausgangsbilder lassen sich mit jedem Prompt neu zeichnen. Auf dem Weg hinein und hinaus wird nichts gefiltert; in unseren Tests kam die Stufe Sehr stark verschwommen statt blockiert heraus.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Beschreiben Sie das ganze Bild, das Sie zurückbekommen möchten, nicht nur die Änderung. Die Trigger-Phrase einer LoRA kommt zuerst. mindestens 1 Zeichen · höchstens 5000 Zeichen |
image_url | Ja | Das Bild, das neu gezeichnet werden soll. Das Ergebnis behält sein Seitenverhältnis; die Auflösungsstufe legt die lange Seite fest. |
resolution | Nein | 1k liefert eine lange Seite von 1.024 Pixeln und ist der Standard; 1.5k liefert 1.536. Beide kosten gleich viel, und das Seitenverhältnis folgt immer der Vorlage. |
strength | Nein | Wie weit sich das Ergebnis von der Vorlage entfernt, von 0 bis 1; standardmäßig 0,7. |
loras | Nein | Bis zu drei Einträge {path, scale}, trainiert auf Z-Image Base; scale 0 bis 4, 1 ist neutral. Eine Stil-LoRA übernimmt hier den Großteil der Umgestaltung. Standardwert: |
output_format | Nein | Standardmäßig JPEG, bei Bedarf PNG oder WebP. Das Format ändert den Preis nicht. |
seed | Nein | Hält Ergebnisse vergleichbar, während Sie die Stärke anpassen. Er garantiert nicht bei jedem Lauf exakt dieselben Pixel. |
Preis
$0.014 / Bild
Abgerechnet pro Bild, zum selben Preis wie Text-zu-Bild. Auflösungsstufe, Ausgabeformat und das Laden von LoRAs ändern den Preis nicht.
Anwendungsfälle
Vom Foto zur Illustration
Laden Sie eine Illustrations-LoRA und schicken Sie Ihre Fotos mit 0,6 hindurch, um eine passende illustrierte Serie zu erhalten.
Varianten einer Aufnahme
Bei 0,75 bis 0,8 behält das Modell Licht und Stimmung eines Fotos, zeichnet aber Pose und Umgebung neu, was für alternative Takes nützlich ist.
Eine trainierte LoRA an echten Bildern testen
Prüfen Sie, wie eine auf Z-Image Base trainierte LoRA echte Fotos behandelt, bevor Sie darauf aufbauen.
Prompt-Leitfaden und Praxistipps
Das ganze Bild beschreiben
Schreiben Sie das Bild auf, das Sie zurückbekommen möchten, nicht die Änderung. „A woman in a green velvet dress singing on a dark stage“ funktioniert; „make it black and white“ allein funktionierte in unseren Tests nicht.
Die LoRA die Umgestaltung übernehmen lassen
Ohne LoRA änderten Anweisungen, das Medium oder das Outfit zu wechseln, unter 0,8 wenig. Eine Stil-LoRA wechselte das Medium schon bei 0,6.
Die Stärke nach der Aufgabe wählen
0,6 für eine Umgestaltung, die alles an seinem Platz lässt, 0,7 für kleine inhaltliche Änderungen, 0,75 bis 0,8 für eine neue Sicht auf die Szene, ab 0,85 für ein neues Bild.
Base-LoRAs verwenden
Eine auf Z-Image Turbo trainierte LoRA zerlegte in unserem Test das Bild auf dieser Ausgabe. Verwenden Sie Dateien, die auf Z-Image Base trainiert sind.
API-Schnellstart
# 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/z-image-base-lora/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
