跳轉到主要內容
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"
    }
  ]
}

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.

從純文字 Prompt 生成可安全商用的圖片。對於在 CometAPI 上的第一次請求，請傳送 prompt，將 num_results 維持為 1，並以 aspect_ratio: "1:1" 開始，除非你已經清楚知道所需的最終版面配置。

​
在以下情況使用此路由

  • 你希望透過一次呼叫取得完成的圖片
  • 你不需要遮罩、輸入圖片或任務輪詢
  • 你想使用更容易透過 CometAPI 導入營運的擬真 Bria 路徑

​
從這個請求開始

  • 保持 Prompt 簡短且具體
  • 在第一次請求中使用 num_results: 1
  • 以 aspect_ratio: "1:1" 開始，除非目標版面配置已經固定
  • 如果你需要長時間保存，請儘快下載回傳的 URL

​
CometAPI 上的回應行為

Bria 的官方文件描述了更廣泛的生成流程，並討論了非同步狀態流程。在 CometAPI 上，此路由使用簡化的 JSON 請求，並會立即回傳最終的 result 陣列，而不是 request_id 加上 status_url。
CometAPI 代理的是 Bria 的能力，而非逐欄位鏡像 Bria 的公開 API。整合時請以本頁 API 參考文件與 Playground 中顯示的請求與回應結構為準。

授權

​
Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

主體

application/json
​
prompt
string
必填

English text prompt for image generation.

範例:

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

​
num_results
integer
預設值:1

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

​
aspect_ratio
enum<string>
預設值:1:1

Requested output aspect ratio.

可用選項:
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
預設值:30

Optional refinement step count.

​
text_guidance_scale
integer
預設值:5

Optional prompt adherence setting.

​
medium
enum<string>

Optional visual medium.

可用選項:
photography,
art
​
prompt_enhancement
boolean
預設值:false

Optional prompt enhancement switch.

​
enhance_image
boolean
預設值:false

Optional image detail enhancement switch.

​
prompt_content_moderation
boolean
預設值:false

Optional moderation switch.

​
ip_signal
boolean
預設值:false

Optional IP warning flag.

​
sync
boolean
預設值:false

Optional sync hint. CometAPI returns final results immediately without setting this field.

回應

200 - application/json

Image generation result.

​
result
object[]
必填