> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Сгенерировать изображение Bria
> Используйте CometAPI Bria POST /bria/text-to-image, чтобы генерировать фотореалистичные изображения 1MP из текста с улучшениями и гибкими соотношениями сторон.
Создавайте коммерчески безопасные изображения из простого текстового prompt. Для первого запроса в CometAPI отправьте `prompt`, оставьте `num_results` равным `1` и начните с `aspect_ratio: "1:1"`, если только вы уже не знаете итоговый макет, который вам нужен.
## Используйте этот маршрут, когда
* Вам нужно получить готовое изображение за один вызов
* Вам не нужны masks, входные изображения или опрос статуса задачи
* Вам нужен фотореалистичный сценарий Bria, который проще внедрить через CometAPI
## Начните с этого запроса
* Держите prompt коротким и конкретным
* Используйте `num_results: 1` для первого запроса
* Начните с `aspect_ratio: "1:1"`, если только целевой макет уже не зафиксирован
* Скачивайте возвращённые URL как можно скорее, если вам нужно длительное хранение
## Поведение ответа в CometAPI
В официальной документации Bria описывается более широкий конвейер генерации и рассматриваются асинхронные сценарии со статусами. В CometAPI этот маршрут использует упрощённый JSON-запрос и сразу возвращает итоговый массив `result`, а не `request_id` и `status_url`.
CometAPI проксирует возможности Bria, а не зеркально повторяет публичный API Bria поле в поле. Используйте формы запроса и ответа, показанные в API reference и Playground на этой странице, как основной источник истины для интеграции.
## OpenAPI
````yaml api/openapi/image/bria/post-generate-image.openapi.json POST /bria/text-to-image
openapi: 3.1.0
info:
title: Generate Image API
version: 1.0.0
description: >-
Generate Bria text-to-image outputs through CometAPI. This route returns
final image URLs directly.
servers:
- url: https://api.cometapi.com
security:
- bearerAuth: []
paths:
/bria/text-to-image:
post:
summary: Generate Bria images
description: >-
Create one or more Bria images from a text prompt. For the most
predictable first request, keep num_results at 1 and use a square aspect
ratio.
operationId: generate_image
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- prompt
properties:
prompt:
type: string
description: English text prompt for image generation.
example: A paper boat floating on calm water at sunrise.
num_results:
type: integer
description: >-
Number of images to generate. Use 1 for the simplest
integration test.
default: 1
aspect_ratio:
type: string
description: Requested output aspect ratio.
enum:
- '1:1'
- '2:3'
- '3:2'
- '3:4'
- '4:3'
- '4:5'
- '5:4'
- '9:16'
- '16:9'
default: '1:1'
seed:
type: integer
description: Optional seed for reproducible results.
negative_prompt:
type: string
description: Optional exclusions for the generated image.
steps_num:
type: integer
description: Optional refinement step count.
default: 30
text_guidance_scale:
type: integer
description: Optional prompt adherence setting.
default: 5
medium:
type: string
description: Optional visual medium.
enum:
- photography
- art
prompt_enhancement:
type: boolean
description: Optional prompt enhancement switch.
default: false
enhance_image:
type: boolean
description: Optional image detail enhancement switch.
default: false
prompt_content_moderation:
type: boolean
description: Optional moderation switch.
default: false
ip_signal:
type: boolean
description: Optional IP warning flag.
default: false
sync:
type: boolean
description: >-
Optional sync hint. CometAPI returns final results
immediately without setting this field.
default: false
default:
prompt: A paper boat floating on calm water at sunrise.
num_results: 1
aspect_ratio: '1:1'
examples:
Validated request:
summary: Validated request
value:
prompt: A paper boat floating on calm water at sunrise.
num_results: 1
aspect_ratio: '1:1'
responses:
'200':
description: Image generation result.
content:
application/json:
schema:
type: object
required:
- result
properties:
result:
type: array
items:
type: object
required:
- urls
- seed
- uuid
properties:
urls:
type: array
items:
type: string
seed:
type: integer
uuid:
type: string
example:
result:
- urls:
- https://example.com/generated.png
seed: 278741175
uuid: 27c39b06-1dfe-11f1-ad57-6ac2c454c04d_278741175
example:
result:
- urls:
- >-
https://temp.bria.ai/api/generate_image/A_paper_boat_..._seed_934469972.png
seed: 934469972
uuid:
x-codeSamples:
- lang: Shell
label: Default
source: |
curl https://api.cometapi.com/bria/text-to-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A paper boat floating on calm water at sunrise.",
"num_results": 1,
"aspect_ratio": "1:1"
}'
- lang: Python
label: Default
source: >
import os
import requests
response = requests.post(
"https://api.cometapi.com/bria/text-to-image",
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
json={
"prompt": "A paper boat floating on calm water at sunrise.",
"num_results": 1,
"aspect_ratio": "1:1"
},
)
print(response.json()) # the route responds synchronously with
result[].urls
- lang: JavaScript
label: Default
source: >
const response = await
fetch("https://api.cometapi.com/bria/text-to-image", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A paper boat floating on calm water at sunrise.",
"num_results": 1,
"aspect_ratio": "1:1"
}),
});
console.log(await response.json()); // the route responds
synchronously with result[].urls
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Bearer token authentication. Use your CometAPI key.
````