Especificações técnicas de bria/expand-image
| Especificação | Detalhes |
|---|---|
| Model ID | bria/expand-image |
| Provedor / família de modelos | Bria Expand, um modelo de expansão de imagem e outpainting da Bria |
| Tarefa principal | Expandir uma imagem além de suas bordas originais gerando novos pixels para se ajustar a uma composição mais larga ou mais alta |
| Tipo de operação da API | Endpoint de edição de imagem / outpainting |
| Endpoint oficial da Bria | POST /v2/image/edit/expand na API de edição de imagens da Bria |
| Formatos de imagem de entrada | JPEG, JPG, PNG, WEBP; a imagem pode ser fornecida como base64 ou como um URL publicamente acessível |
| Comportamento de saída | Retorna um URL da imagem expandida; a Bria v2 pode retornar resultados síncronos ou respostas assíncronas com request_id e status_url, dependendo do modo de processamento |
| Controles de proporção de aspecto | Suporta proporções predefinidas como 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16 e 16:9, além de proporções personalizadas em ponto flutuante de 0.5 a 3.0 |
| Controles de canvas | Pode usar canvas_size, original_image_size e original_image_location explícitos quando não estiver usando aspect_ratio |
| Limites do canvas | A área recomendada de canvas fica dentro de 5000×5000 pixels de área total, com uma área máxima permitida de 25 milhões de pixels para dimensionamento explícito do canvas |
| Suporte a prompt | Um prompt opcional em inglês pode orientar a expansão; se omitido, a Bria pode gerar automaticamente um prompt a partir da imagem de entrada |
| Opções de moderação | Suporta moderação de prompt e controles de moderação de saída visual na API da Bria |
| Posicionamento comercial | A Bria descreve o modelo como treinado exclusivamente em dados licenciados para uso comercial seguro |
O que é bria/expand-image?
bria/expand-image é o identificador de plataforma da CometAPI para o modelo de expansão de imagem da Bria, projetado para estender uma imagem existente além de seus limites originais preservando a continuidade visual. Na prática, é um modelo de outpainting: em vez de recortar uma imagem para se ajustar a um novo formato, ele gera conteúdo adicional ao redor da imagem original para que o resultado final corresponda a uma razão de aspecto ou layout de canvas alvo.
Este modelo é voltado para fluxos de trabalho como adaptar criativos para veiculações em redes sociais, converter imagens em retrato em banners em paisagem, criar fundo extra ao redor de um sujeito ou reenquadrar visuais de produto e marketing sem editar manualmente cada material. A documentação da Bria posiciona esse recurso dentro de sua suíte mais ampla de edição de imagens, ao lado de ferramentas como edição de fundo, apagamento, preenchimento generativo e upscaling.
Uma parte notável do posicionamento da Bria é a prontidão para uso corporativo e comercial. A Bria afirma que seus modelos são treinados com dados licenciados e os comercializa como adequados para uso comercial de menor risco, o que pode ser relevante para equipes que constroem pipelines de design, marca ou ecommerce em produção.
Principais recursos de bria/expand-image
- Outpainting de imagem de alta qualidade: Estende imagens além de suas bordas gerando novos pixels que continuam a cena original, em vez de simplesmente esticar ou recortar a fonte.
- Adaptação da proporção de aspecto: Permite expandir para formatos-alvo comuns como
16:9,9:16,1:1e outros, o que é útil para reaproveitar um ativo em vários canais. - Posicionamento preciso no canvas: Suporta
canvas_size,original_image_sizeeoriginal_image_locationpara que developers controlem exatamente onde a imagem original fica na nova composição. - Orientação opcional por prompt: Aceita um prompt de texto para direcionar as regiões recém-geradas; se nenhum prompt for fornecido, o serviço pode derivar automaticamente um a partir da imagem.
- Métodos de entrada flexíveis: Aceita dados de imagem codificados em base64 ou um URL de imagem publicamente acessível, facilitando a integração com web apps, pipelines de ativos e sistemas de automação.
- Fluxo de API adequado para produção: A Bria v2 suporta processamento assíncrono com
request_idestatus_url, o que é útil para jobs de imagem mais longos e orquestração de backend. - Opções de moderação integradas: Inclui configurações de moderação de prompt e de saída para ajudar equipes a impor controles de política em integrações de produção.
- Posicionamento para uso comercial: A Bria promove o modelo como treinado em dados licenciados para implantação comercial mais segura, relevante para operações de conteúdo corporativo.
Como acessar e integrar bria/expand-image
Etapa 1: Cadastre-se para obter a chave de API
Para começar, cadastre-se na CometAPI e gere sua chave de API no dashboard. Com uma chave de API, você pode autenticar solicitações para o modelo bria/expand-image e quaisquer outros modelos compatíveis na plataforma.
Etapa 2: Envie solicitações para a API bria/expand-image
Use o endpoint compatível com Bria da CometAPI em POST /bria/image/edit/expand-image.
curl https://api.cometapi.com/bria/image/edit/expand-image \
-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. Consulte periodicamente GET /bria/{task_id} para verificar o status do processamento e recuperar o URL da imagem de saída quando concluído.