Перейти к основному содержанию
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"
    }
  ]
}
Создавайте коммерчески безопасные изображения по простому текстовому Prompt. Для первого запроса в CometAPI передайте prompt, оставьте num_results равным 1 и начните с aspect_ratio: "1:1", если только вы уже не знаете нужную итоговую компоновку.

Используйте этот маршрут, когда

  • Вам нужно получить готовое изображение за один вызов
  • Вам не нужны маски, входные изображения или опрос статуса задачи
  • Вам нужен фотореалистичный путь Bria, который проще внедрить через CometAPI

Начните с этого запроса

  • Держите Prompt коротким и конкретным
  • Используйте num_results: 1 для первой smoke test
  • Начните с aspect_ratio: "1:1", если целевая компоновка уже не зафиксирована
  • Скачивайте возвращённые URL как можно скорее, если вам нужно длительное хранение

Поведение ответа в CometAPI

Официальная документация Bria описывает более широкий пайплайн генерации и рассматривает асинхронные сценарии со статусами. В CometAPI этот маршрут использует упрощённый JSON-запрос и в текущих smoke test сразу возвращал финальный массив result, а не request_id вместе с status_url.
CometAPI проксирует возможности Bria, а не зеркально повторяет публичный API Bria поле в поле. Используйте формы запроса и ответа, показанные в API reference и Playground на этой странице, как источник истины для интеграции.

Авторизации

Authorization
string
header
обязательно

Bearer token authentication. Use your CometAPI key.

Тело

application/json
prompt
string
обязательно

English text prompt for image generation.

Пример:

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

num_results
integer
по умолчанию:1

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

aspect_ratio
enum<string>
по умолчанию:1:1

Requested output aspect ratio.

Доступные опции:
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
по умолчанию:30

Optional refinement step count.

text_guidance_scale
integer
по умолчанию:5

Optional prompt adherence setting.

medium
enum<string>

Optional visual medium.

Доступные опции:
photography,
art
prompt_enhancement
boolean
по умолчанию:false

Optional prompt enhancement switch.

enhance_image
boolean
по умолчанию:false

Optional image detail enhancement switch.

prompt_content_moderation
boolean
по умолчанию:false

Optional moderation switch.

ip_signal
boolean
по умолчанию:false

Optional IP warning flag.

sync
boolean
по умолчанию:false

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

Ответ

200 - application/json

Image generation result.

result
object[]
обязательно