Перейти до основного вмісту
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", якщо ви вже не знаєте точний фінальний макет, який вам потрібен.

Використовуйте цей маршрут, коли

  • Вам потрібне готове зображення за один виклик
  • Вам не потрібні маски, вхідні зображення або опитування task
  • Ви хочете використовувати фотореалістичний шлях 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 та 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[]
обов'язково