Saltar para o conteúdo principal
POST
/
bria
/
image
/
edit
/
{action}
curl --request POST \ --url https://api.cometapi.com/bria/image/edit/{action} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "image": "https://raw.githubusercontent.com/cometapi-dev/.github/refs/heads/main/assets/img/original_image.png", "mask": "https://raw.githubusercontent.com/cometapi-dev/.github/refs/heads/main/assets/img/mask_image.png" } '
{}

Visão geral

A API de Edição de Imagem da Bria oferece um conjunto abrangente de ferramentas para manipular e aprimorar imagens.
Após uma chamada de API bem-sucedida, use o request_id retornado para consultar os resultados por meio do endpoint Query Status.O parâmetro sync é fixo nesta interface — você não precisa especificá-lo.

Operações compatíveis

OperationDescriptionDocumentation
eraseRemover objetos de imagensBria Erase Docs
gen_fillPreenchimento generativo para áreas mascaradasBria Gen Fill Docs
expandExpandir a tela da imagemBria Expand Docs
enhanceMelhorar a qualidade da imagemBria Enhance Docs
increase_resolutionAumentar a resolução da imagemBria Upscale Docs
replace_backgroundSubstituir o fundo da imagemBria Background Docs
Consulte a documentação oficial para ver a lista de parâmetros específica de cada operação.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Cabeçalhos

Content-Type
string

Must be application/json.

Parâmetros de caminho

action
string
obrigatório

Editing action to perform. Supported values: erase, gen_fill, expand, enhance, increase_resolution, replace_background.

Corpo

application/json
image
string

Source image as a public URL or base64-encoded data URI. Accepted formats: JPEG, PNG, WebP. Maximum 12 MB.

mask
string

Mask image as a public URL or base64. White areas mark the region to edit; black areas are preserved. Required for erase, gen_fill, and expand actions.

prompt
string

Text description of the desired edit. Required for gen_fill and replace_background actions.

num_results
integer

Number of result variants to generate. Default: 1.

sync
boolean

When true, the response blocks until results are ready. When false (default), returns immediately with placeholder URLs that can be polled.

Resposta

200 - application/json

Success

The response is of type object.