Langsung ke konten utama
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"
    }
  ]
}
Buat gambar yang aman untuk penggunaan komersial dari prompt teks biasa. Untuk permintaan pertama di CometAPI, kirim prompt, pertahankan num_results di 1, dan mulai dengan aspect_ratio: "1:1" kecuali Anda sudah mengetahui tata letak akhir yang dibutuhkan.

​
Gunakan rute ini ketika

  • Anda ingin gambar jadi dalam satu panggilan
  • Anda tidak memerlukan mask, input gambar, atau polling task
  • Anda menginginkan jalur Bria yang fotorealistis dan lebih mudah dioperasionalkan melalui CometAPI

​
Mulai dengan permintaan ini

  • Buat prompt singkat dan konkret
  • Gunakan num_results: 1 untuk smoke test pertama Anda
  • Mulai dengan aspect_ratio: "1:1" kecuali tata letak target sudah ditentukan
  • Unduh URL yang dikembalikan secepatnya 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, dalam smoke test saat ini, langsung mengembalikan array result final alih-alih request_id plus status_url.
CometAPI mem-proxy kapabilitas Bria alih-alih mencerminkan API publik Bria bidang demi bidang. Gunakan bentuk permintaan dan respons yang ditampilkan dalam referensi API dan Playground pada halaman ini sebagai sumber kebenaran untuk integrasi.

Otorisasi

​
Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Body

application/json
​
prompt
string
wajib

English text prompt for image generation.

Contoh:

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

​
num_results
integer
default:1

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

​
aspect_ratio
enum<string>
default:1:1

Requested output aspect ratio.

Opsi yang tersedia:
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
default:30

Optional refinement step count.

​
text_guidance_scale
integer
default:5

Optional prompt adherence setting.

​
medium
enum<string>

Optional visual medium.

Opsi yang tersedia:
photography,
art
​
prompt_enhancement
boolean
default:false

Optional prompt enhancement switch.

​
enhance_image
boolean
default:false

Optional image detail enhancement switch.

​
prompt_content_moderation
boolean
default:false

Optional moderation switch.

​
ip_signal
boolean
default:false

Optional IP warning flag.

​
sync
boolean
default:false

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

Respons

200 - application/json

Image generation result.

​
result
object[]
wajib