Prompt-Enhancement

​

Wann einsetzen

• Dein Prompt kurz ist (wenige Wörter oder ein einzelner Satz) und du möchtest, dass das Modell Komposition, Beleuchtung und Stimmung ergänzt.
• Du ein Produkt baust, bei dem Endnutzer beiläufige Prompts eingeben, die von einer Erweiterung profitieren.
• Du ein Bild bearbeitest und möchtest, dass die Anweisung mit Bewusstsein für den sichtbaren Inhalt umgeschrieben wird.
• Du konsistentere, detailliertere Ergebnisse willst, ohne lange Prompts von Hand zu schreiben.

​

Schritt 1: Request mit aktiviertem Enhancement senden

curl https://api.venice.ai/api/v1/image/generate \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-sd35",
    "prompt": "a cabin in the woods",
    "enhance_prompt": true,
    "format": "webp"
  }'

​

Schritt 2: Enhanced Prompt aus dem Response-Header lesen

import base64
import os
from urllib.parse import unquote

import requests

response = requests.post(
    "https://api.venice.ai/api/v1/image/generate",
    headers={
        "Authorization": f"Bearer {os.environ['VENICE_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "venice-sd35",
        "prompt": "a cabin in the woods",
        "enhance_prompt": True,
        "format": "webp",
    },
)

data = response.json()

enhanced = response.headers.get("x-venice-enhanced-prompt")
if enhanced:
    print("Enhanced prompt:", unquote(enhanced))
else:
    print("No enhancement was applied; original prompt was used.")

image_bytes = base64.b64decode(data["images"][0])
with open("output.webp", "wb") as f:
    f.write(image_bytes)

import fs from "fs";

const response = await fetch("https://api.venice.ai/api/v1/image/generate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VENICE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "venice-sd35",
    prompt: "a cabin in the woods",
    enhance_prompt: true,
    format: "webp",
  }),
});

const data = await response.json();

const enhanced = response.headers.get("x-venice-enhanced-prompt");
if (enhanced) {
  console.log("Enhanced prompt:", decodeURIComponent(enhanced));
} else {
  console.log("No enhancement was applied; original prompt was used.");
}

const imageBuffer = Buffer.from(data.images[0], "base64");
fs.writeFileSync("output.webp", imageBuffer);

​

Enhancement für Bildbearbeitungen nutzen

curl https://api.venice.ai/api/v1/image/edit \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -o edited.png \
  -d '{
    "image": "https://example.com/cabin.jpg",
    "prompt": "make it winter",
    "enhance_prompt": true
  }'

curl https://api.venice.ai/api/v1/image/multi-edit \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -o edited.png \
  -d '{
    "images": [
      "https://example.com/cabin.jpg",
      "https://example.com/snow-reference.jpg"
    ],
    "prompt": "make the first image match this winter atmosphere",
    "enhance_prompt": true
  }'

​

Verhalten

​

Preise

• Berechnet wird nur, wenn tatsächlich ein Rewrite erzeugt und angewendet wird. Wenn Enhancement übersprungen wird oder auf deinen ursprünglichen Prompt zurückfällt, fällt kein Aufschlag an.
• Der Aufschlag wird auf dem Erfolgs-Pfad des Bildes abgerechnet. Wenn die Generierung mit einem Content-Verstoß endet, wird das Enhancement nicht berechnet.
• Wenn du mit variants mehrere Bilder anforderst, wird der gemeinsame Rewrite höchstens einmal pro Request abgerechnet, nicht einmal pro Variante.

​

Enhancement zusammen mit Variants nutzen

curl https://api.venice.ai/api/v1/image/generate \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-sd35",
    "prompt": "a cabin in the woods",
    "enhance_prompt": true,
    "variants": 4
  }'

​

Prompting-Tipps

1. Halte deinen Eingabe-Prompt auf das Motiv und alle nicht verhandelbaren Details fokussiert. Enhancement ergänzt Stil, Beleuchtung und Komposition drumherum.
2. Logge während der Entwicklung den Header x-venice-enhanced-prompt, damit du lernst, was Enhancement hinzufügt, und entscheiden kannst, wann du lieber selbst Prompts schreibst.
3. Für reproduzierbare Generierungsergebnisse über einen Batch hinweg: einmal mit Enhancement generieren, den Enhanced Prompt aus dem Header übernehmen und dann exakt diesen Text mit ausgeschaltetem enhance_prompt wiederverwenden.
4. Für die Bildgenerierung kombiniere den übernommenen Prompt mit einem festen seed, um andere Parameteränderungen zu vergleichen, ohne den Rewrite erneut zu erzeugen.

​

Fehler

​

Verwandt

• Bildgenerierung — der vollständige Generierungs-Guide, inklusive Größen, Styles und Binär-Antworten.
• Bildbearbeitung — Single-Image-Edits, mehrschichtige Multi-Edit-Requests und Binär-Antworten.
• Bilder generieren (API-Referenz) — alle Request- und Response-Felder für POST /image/generate.
• Bild bearbeiten (API-Referenz) — Request-Felder für POST /image/edit.
• Multi-Edit Bild (API-Referenz) — Request-Felder für POST /image/multi-edit.
• Image-Modelle — Modellliste, Preise und promptCharacterLimit pro Modell.