> ## 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.
# Buat gambar Bria
> Gunakan CometAPI Bria POST /bria/text-to-image untuk membuat gambar fotorealistis 1MP dari teks dengan peningkatan dan rasio aspek yang fleksibel.
Buat gambar yang aman untuk penggunaan komersial dari prompt teks biasa. Untuk permintaan pertama di CometAPI, kirim `prompt`, pertahankan `num_results` pada `1`, dan mulai dengan `aspect_ratio: "1:1"` kecuali Anda sudah mengetahui tata letak akhir yang dibutuhkan.
## Gunakan rute ini saat
* Anda ingin gambar akhir dalam satu panggilan
* Anda tidak memerlukan mask, input gambar, atau polling task
* Anda menginginkan alur Bria fotorealistis yang lebih mudah dioperasionalkan melalui CometAPI
## Mulai dengan permintaan ini
* Jaga prompt tetap singkat dan konkret
* Gunakan `num_results: 1` untuk permintaan pertama Anda
* Mulai dengan `aspect_ratio: "1:1"` kecuali tata letak target sudah ditetapkan
* Unduh URL yang dikembalikan sesegera mungkin jika Anda memerlukan retensi jangka panjang
## Perilaku respons di CometAPI
Dokumentasi resmi Bria menjelaskan pipeline pembuatan yang lebih luas dan membahas alur status async. Di CometAPI, rute ini menggunakan permintaan JSON yang disederhanakan dan langsung mengembalikan array `result` final alih-alih `request_id` ditambah `status_url`.
CometAPI mem-proxy kapabilitas Bria alih-alih mencerminkan API publik Bria bidang demi bidang. Gunakan bentuk permintaan dan respons yang ditampilkan di referensi API dan Playground halaman ini sebagai sumber kebenaran untuk integrasi.
## 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.
````