Pular para o conteúdo principal
O upscaling de imagens melhora a resolução e a qualidade visual de uma imagem existente. Envie uma imagem codificada em base64 para /image/upscale, escolha um fator de escala e a Venice retornará a imagem aprimorada como dados binários. Use o upscaling de imagens quando você já tem uma imagem e deseja uma saída em resolução mais alta. Use geração de imagens quando precisar criar uma imagem a partir de um prompt e edição de imagens quando precisar alterar o conteúdo da imagem.

Uso Básico

import base64
import os
from pathlib import Path

import requests

image_base64 = base64.b64encode(Path("input.jpg").read_bytes()).decode("utf-8")

response = requests.post(
    "https://api.venice.ai/api/v1/image/upscale",
    headers={
        "Authorization": f"Bearer {os.environ['VENICE_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "image": image_base64,
        "scale": 2,
    },
)

response.raise_for_status()
Path("upscaled.png").write_bytes(response.content)
import { readFile, writeFile } from "node:fs/promises";

const image = await readFile("input.jpg");

const response = await fetch("https://api.venice.ai/api/v1/image/upscale", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VENICE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    image: image.toString("base64"),
    scale: 2,
  }),
});

if (!response.ok) {
  throw new Error(await response.text());
}

const output = Buffer.from(await response.arrayBuffer());
await writeFile("upscaled.png", output);
IMAGE_BASE64=$(base64 < input.jpg | tr -d '\n')

curl https://api.venice.ai/api/v1/image/upscale \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"image\": \"$IMAGE_BASE64\",
    \"scale\": 2
  }" \
  --output upscaled.png

Parâmetros

ParâmetroTipoObrigatórioDescrição
imagestringSimImagem de origem codificada em base64.
scalenumberNãoFator de upscaling. Use os valores suportados listados na referência da API e no catálogo de modelos.
A resposta são dados binários da imagem, não JSON. Grave o corpo da resposta diretamente em um arquivo ou faça streaming para o armazenamento.

Dicas de Entrada

  • Comece com a imagem de origem mais limpa que você tiver. O upscaling melhora os detalhes, mas não pode recuperar totalmente informações que não estão presentes.
  • Use fatores de escala moderados para fluxos de trabalho em produção. Saídas muito grandes podem aumentar a latência e o tamanho do arquivo.
  • Mantenha a imagem original por perto se precisar comparar a qualidade ou tentar novamente com configurações diferentes.

Recursos Relacionados