生成圖片

使用 CometAPI Bria POST /bria/text-to-image，透過文字生成具增強效果且支援彈性長寬比的 1MP 擬真圖片。

POST /bria/text-to-image

Generate Bria images

cURL

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."
}
'

200

{
  "result": [
    {
      "urls": [
        "https://example.com/generated.png"
      ],
      "seed": 278741175,
      "uuid": "27c39b06-1dfe-11f1-ad57-6ac2c454c04d_278741175"
    }
  ]
}

透過純文字 Prompt 生成可商用且安全的圖片。若這是你在 CometAPI 上的第一次請求，請傳送 prompt、將 num_results 保持為 1，並以 aspect_ratio: "1:1" 開始，除非你已經明確知道最終需要的版面配置。

​

適合在以下情況使用此路由

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

​

從這個請求開始

• 讓 Prompt 簡短且具體
• 第一次 smoke test 使用 num_results: 1
• 先用 aspect_ratio: "1:1" 開始，除非目標版面已經固定
• 如果你需要長時間保存，請及時下載回傳的 URL

​

CometAPI 上的回應行為

Bria 的官方文件描述了更完整的生成流程，並討論了非同步狀態流程。在 CometAPI 上，這個路由使用簡化的 JSON 請求，而且在目前的 smoke test 中，會立即回傳最終的 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. Current CometAPI smoke tests returned final results immediately without setting this field.

回應

200 - application/json

Image generation result.

result · object[] · 必填

Show child attributes