Aprimoramento de prompt

​

Quando usar

• Seu prompt é curto (poucas palavras ou uma única frase) e você quer que o modelo preencha composição, iluminação e clima.
• Você está construindo um produto no qual usuários finais digitam prompts casuais que se beneficiam de expansão.
• Você está editando uma imagem e quer que a instrução seja reescrita com percepção do conteúdo visível.
• Você quer saídas mais consistentes e detalhadas sem escrever manualmente prompts longos.

​

Passo 1: Envie uma requisição com o aprimoramento ativado

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

​

Passo 2: Leia o prompt aprimorado no cabeçalho da resposta

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

​

Usando aprimoramento para edições de imagem

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

​

Comportamento

​

Preços

• Você só é cobrado quando uma reescrita é efetivamente gerada e aplicada. Se o aprimoramento for ignorado ou falhar de forma aberta para seu prompt original, não há sobretaxa.
• A sobretaxa é cobrada no caminho de sucesso da imagem. Se a geração terminar em violação de conteúdo, o aprimoramento não é cobrado.
• Quando você solicita múltiplas imagens com variants, a reescrita compartilhada é cobrada no máximo uma vez por requisição, e não uma vez por variante.

​

Usando aprimoramento com 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
  }'

​

Dicas de prompt

1. Mantenha seu prompt de entrada focado no sujeito e em quaisquer detalhes inegociáveis. O aprimoramento preenche estilo, iluminação e composição ao redor dele.
2. Registre o cabeçalho x-venice-enhanced-prompt durante o desenvolvimento para aprender o que o aprimoramento adiciona e decidir quando você preferiria escrever os prompts manualmente.
3. Para resultados de geração repetíveis em um lote, gere uma vez com aprimoramento, capture o prompt aprimorado a partir do cabeçalho e depois reutilize esse texto exato com enhance_prompt desativado.
4. Para geração de imagens, combine o prompt capturado com um seed fixo para comparar outras mudanças de parâmetros sem gerar nova reescrita.

​

Erros

​

Relacionados

• Geração de imagens — o guia completo de geração, incluindo dimensionamento, estilos e respostas binárias.
• Edição de imagens — edições de imagem única, requisições multi-edit em camadas e respostas binárias.
• Gerar imagens (referência da API) — todos os campos de requisição e resposta para POST /image/generate.
• Editar imagem (referência da API) — campos de requisição para POST /image/edit.
• Multi-Edit de imagem (referência da API) — campos de requisição para POST /image/multi-edit.
• Modelos de imagem — lista de modelos, preços e promptCharacterLimit por modelo.