bria/increase-resolution

Especificações técnicas de bria/increase-resolution

O que é bria/increase-resolution?

bria/increase-resolution é o endpoint de upscaling de imagem da Bria para aumentar a resolução sem reinventar ou regenerar o conteúdo subjacente. A Bria descreve essa rota como uma capacidade dedicada de aumento de resolução que preserva a imagem original em vez de adicionar detalhes inventados, tornando-a adequada para fluxos de trabalho que exigem ampliação mais limpa com fidelidade visual previsível.

Este modelo faz parte do conjunto de Image Editing API da Bria, que inclui endpoints específicos para tarefas como expansão, edição de fundo, mascaramento e remoção. Dentro desse conjunto, bria/increase-resolution é a opção especializada para upscaling direto.

Como a Bria diferencia essa rota do endpoint separado “Enhance Image”, bria/increase-resolution deve ser entendido como uma ferramenta de super-resolução com foco na preservação: ele aumenta a resolução da imagem utilizando um método de upscaling dedicado, enquanto a rota de enhancement é destinada a regenerar texturas mais ricas ou adicionar riqueza visual.

Principais recursos de bria/increase-resolution

• Resolução ampliada: Aumenta as imagens de entrada pelos multiplicadores suportados de 2x ou 4x, oferecendo aos desenvolvedores um caminho simples para obter saídas em maior resolução a partir de ativos existentes.
• Comportamento que preserva o conteúdo: Projetado para preservar o conteúdo original da imagem em vez de regenerá-lo ou alterá-lo criativamente, o que é útil para pipelines de imagem determinísticos e sensíveis à marca.
• Suporte a saídas grandes: Suporta upscaling até uma área máxima de saída de 8192 × 8192 pixels, permitindo entregas em alta resolução para muitos casos de uso em produção.
• Ingestão de entrada flexível: Aceita URLs de imagem publicamente acessíveis ou payloads de imagem codificados em Base64, facilitando a integração com fluxos de mídia hospedada e upload direto.
• Ampla compatibilidade de formatos: Funciona com entradas JPEG, JPG, PNG e WEBP, enquanto a documentação do endpoint da Bria também observa restrições sobre modos de arquivo/cor suportados e respostas 415 para casos não suportados.
• Preservação de transparência: Inclui a opção preserve_alpha para que imagens com canal alfa mantenham pixels transparentes e parcialmente transparentes na saída.
• Processamento compatível com assíncrono: Suporta processamento assíncrono por padrão, retornando uma URL de status para acompanhar jobs de longa duração, além de oferecer modo síncrono quando necessário.
• Controles de moderação integrados: A Bria documenta moderação tanto da imagem de entrada quanto da imagem de saída para essa rota, ajudando equipes a reforçar um uso de produção mais seguro.

Como acessar e integrar bria/increase-resolution

Etapa 1: Cadastre-se para obter a chave de API

Para acessar a API bria/increase-resolution, primeiro crie uma conta no CometAPI e gere sua chave de API no painel. Após entrar, armazene a chave com segurança como uma variável de ambiente, como COMETAPI_API_KEY. Essa chave será usada para autenticar todas as solicitações ao bria/increase-resolution.

Etapa 2: Envie solicitações para a API bria/increase-resolution

Use o endpoint compatível com Bria do CometAPI em POST /bria/image/edit/increase-resolution.

curl https://api.cometapi.com/bria/image/edit/increase-resolution \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -d '{
    "prompt": "A paper boat floating on calm water at sunrise.",
    "num_results": 1
  }'

Etapa 3: Recupere e verifique os resultados

A API retorna um ID de tarefa. Faça polling em GET /bria/{task_id} para verificar o status do processamento e recuperar a URL da imagem de saída quando concluído.