Chuyển đến nội dung chính
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"
    }
  ]
}
Tạo các 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ỉ với một lần gọi
  • Bạn không cần mask, đầu vào hình ảnh hoặc polling tác vụ
  • Bạn muốn dùng quy trình Bria thiên về ảnh chân thực, dễ triển khai vận hành hơn thông qua CometAPI

​
Bắt đầu với request này

  • Giữ prompt ngắn gọn và cụ thể
  • Dùng num_results: 1 cho bài smoke test đầ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 trữ lâu dài

​
Cách response hoạt động trên CometAPI

Tài liệu chính thức của Bria mô tả một pipeline tạo ảnh 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 request JSON được đơn giản hóa và, trong các bài smoke test hiện tại, đã trả về ngay một mảng result cuối cùng thay vì request_id cùng với 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 field 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.

Ủy quyền

​
Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Nội dung

application/json
​
prompt
string
bắt buộc

English text prompt for image generation.

Ví dụ:

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

​
num_results
integer
mặc định:1

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

​
aspect_ratio
enum<string>
mặc định:1:1

Requested output aspect ratio.

Tùy chọn có sẵn:
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
mặc định:30

Optional refinement step count.

​
text_guidance_scale
integer
mặc định:5

Optional prompt adherence setting.

​
medium
enum<string>

Optional visual medium.

Tùy chọn có sẵn:
photography,
art
​
prompt_enhancement
boolean
mặc định:false

Optional prompt enhancement switch.

​
enhance_image
boolean
mặc định:false

Optional image detail enhancement switch.

​
prompt_content_moderation
boolean
mặc định:false

Optional moderation switch.

​
ip_signal
boolean
mặc định:false

Optional IP warning flag.

​
sync
boolean
mặc định:false

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

Phản hồi

200 - application/json

Image generation result.

​
result
object[]
bắt buộc