Saltar para o conteúdo principal
POST
/
bria
/
text-to-image
Generate Bria images
curl --request POST \
  --url https://api.cometapi.com/bria/text-to-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A paper boat floating on calm water at sunrise."
}
'
{
  "result": [
    {
      "urls": [
        "https://example.com/generated.png"
      ],
      "seed": 278741175,
      "uuid": "27c39b06-1dfe-11f1-ad57-6ac2c454c04d_278741175"
    }
  ]
}
Gere imagens seguras para uso comercial a partir de um prompt de texto simples. Para uma primeira solicitação no CometAPI, envie prompt, mantenha num_results em 1 e comece com aspect_ratio: "1:1" a menos que você já saiba o layout final de que precisa.

Use esta rota quando

  • Você quiser uma imagem finalizada em uma única chamada
  • Você não precisar de máscaras, entradas de imagem ou polling de tarefas
  • Você quiser um caminho fotorrealista do Bria que seja mais fácil de operacionalizar por meio do CometAPI

Comece com esta solicitação

  • Mantenha o prompt curto e objetivo
  • Use num_results: 1 no seu primeiro teste rápido
  • Comece com aspect_ratio: "1:1" a menos que o layout de destino já esteja definido
  • Baixe os URLs retornados rapidamente se precisar de retenção prolongada

Comportamento da resposta no CometAPI

A documentação oficial da Bria descreve um pipeline de geração mais amplo e discute fluxos de status assíncronos. No CometAPI, esta rota usa uma solicitação JSON simplificada e, nos testes rápidos atuais, retornou imediatamente um array result final em vez de um request_id com status_url.
O CometAPI faz proxy da capacidade da Bria em vez de espelhar a API pública da Bria campo por campo. Use os formatos de solicitação e resposta mostrados na referência de API e no Playground desta página como fonte de verdade para a integração.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
prompt
string
obrigatório

English text prompt for image generation.

Exemplo:

"A paper boat floating on calm water at sunrise."

num_results
integer
padrão:1

Number of images to generate. Use 1 for the simplest integration test.

aspect_ratio
enum<string>
padrão:1:1

Requested output aspect ratio.

Opções disponíveis:
1:1,
2:3,
3:2,
3:4,
4:3,
4:5,
5:4,
9:16,
16:9
seed
integer

Optional seed for reproducible results.

negative_prompt
string

Optional exclusions for the generated image.

steps_num
integer
padrão:30

Optional refinement step count.

text_guidance_scale
integer
padrão:5

Optional prompt adherence setting.

medium
enum<string>

Optional visual medium.

Opções disponíveis:
photography,
art
prompt_enhancement
boolean
padrão:false

Optional prompt enhancement switch.

enhance_image
boolean
padrão:false

Optional image detail enhancement switch.

prompt_content_moderation
boolean
padrão:false

Optional moderation switch.

ip_signal
boolean
padrão:false

Optional IP warning flag.

sync
boolean
padrão:false

Optional sync hint. Current CometAPI smoke tests returned final results immediately without setting this field.

Resposta

200 - application/json

Image generation result.

result
object[]
obrigatório