Mejora de prompts

​

Cuándo usarla

• Tu prompt es corto (unas pocas palabras o una sola frase) y quieres que el modelo complete la composición, la iluminación y el ambiente.
• Estás construyendo un producto en el que los usuarios finales escriben prompts informales que se benefician de una expansión.
• Estás editando una imagen y quieres que la instrucción se reescriba con conciencia de su contenido visible.
• Quieres una salida más consistente y detallada sin escribir a mano prompts largos.

​

Paso 1: envía una solicitud con la mejora activada

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

​

Paso 2: lee el prompt mejorado desde la cabecera de la respuesta

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);

​

Usar la mejora para editar imágenes

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
  }'

​

Comportamiento

​

Precios

• Solo se te cobra cuando realmente se genera y aplica una reescritura. Si la mejora se omite o falla-open a tu prompt original, no hay recargo.
• El recargo se factura en la vía de éxito de la imagen. Si la generación termina en una violación de contenido, la mejora no se cobra.
• Cuando solicitas varias imágenes con variants, la reescritura compartida se factura como máximo una vez por solicitud, no una vez por variante.

​

Usar la mejora con variants

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
  }'

​

Consejos para prompts

1. Mantén tu prompt de entrada centrado en el sujeto y en los detalles innegociables. La mejora rellena el estilo, la iluminación y la composición a su alrededor.
2. Registra la cabecera x-venice-enhanced-prompt durante el desarrollo para aprender qué añade la mejora y decidir cuándo prefieres escribir los prompts a mano.
3. Para obtener resultados de generación repetibles en un lote, genera una vez con la mejora, captura el prompt mejorado desde la cabecera y luego reutiliza ese texto exacto con enhance_prompt desactivado.
4. Para la generación de imágenes, combina el prompt capturado con un seed fijo para comparar otros cambios de parámetros sin volver a reescribir.

​

Errores

​

Relacionado

• Generación de imágenes — la guía completa de generación, incluyendo tamaños, estilos y respuestas binarias.
• Edición de imágenes — ediciones de una sola imagen, solicitudes multi-edit en capas y respuestas binarias.
• Generar imágenes (referencia de la API) — todos los campos de solicitud y respuesta para POST /image/generate.
• Editar imagen (referencia de la API) — campos de solicitud para POST /image/edit.
• Multi-Edit de imagen (referencia de la API) — campos de solicitud para POST /image/multi-edit.
• Modelos de imagen — lista de modelos, precios y promptCharacterLimit por modelo.