> ## 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.
# Tạo ảnh Bria
> Sử dụng CometAPI Bria POST /bria/text-to-image để tạo ảnh chân thực 1MP từ văn bản với các cải tiến và tỷ lệ khung hình linh hoạt.
Tạo hình ảnh an toàn cho mục đích thương mại từ một Prompt văn bản đơn giản. Với yêu cầu đầu tiên trên CometAPI, hãy gửi `prompt`, giữ `num_results` ở `1`, và bắt đầu với `aspect_ratio: "1:1"` trừ khi bạn đã biết rõ bố cục cuối cùng mình cần.
## Sử dụng route này khi
* Bạn muốn có một hình ảnh hoàn chỉnh chỉ trong một lệnh gọi
* Bạn không cần mask, ảnh đầu vào hoặc polling tác vụ
* Bạn muốn một quy trình Bria chân thực, dễ vận hành hơn thông qua CometAPI
## Bắt đầu với yêu cầu này
* Giữ prompt ngắn gọn và cụ thể
* Dùng `num_results: 1` cho yêu cầu đầu tiên của bạn
* Bắt đầu với `aspect_ratio: "1:1"` trừ khi bố cục đích đã được cố định
* Tải xuống các URL được trả về sớm nếu bạn cần lưu giữ lâu dài
## Hành vi phản hồi trên CometAPI
Tài liệu chính thức của Bria mô tả một pipeline tạo sinh rộng hơn và đề cập đến các luồng trạng thái async. Trên CometAPI, route này sử dụng một yêu cầu JSON được đơn giản hóa và trả về ngay một mảng `result` cuối cùng thay vì `request_id` kèm `status_url`.
CometAPI proxy khả năng của Bria thay vì phản chiếu API công khai của Bria theo từng trường một. Hãy dùng cấu trúc request và response được hiển thị trong phần tham chiếu API và Playground của trang này làm nguồn chuẩn để tích hợp.
## 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.
````