Bria
生成圖片
使用 CometAPI Bria POST /bria/text-to-image，透過文字生成具增強效果且支援彈性長寬比的 1MP 擬真圖片。
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"
}
]
}透過純文字 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 中顯示的請求與回應結構作為唯一依據。
授權
Bearer token authentication. Use your CometAPI key.
主體
application/json
English text prompt for image generation.
範例:
"A paper boat floating on calm water at sunrise."
Number of images to generate. Use 1 for the simplest integration test.
Requested output aspect ratio.
可用選項:
1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 Optional seed for reproducible results.
Optional exclusions for the generated image.
Optional refinement step count.
Optional prompt adherence setting.
Optional visual medium.
可用選項:
photography, art Optional prompt enhancement switch.
Optional image detail enhancement switch.
Optional moderation switch.
Optional IP warning flag.
Optional sync hint. Current CometAPI smoke tests returned final results immediately without setting this field.
回應
200 - application/json
Image generation result.
Show child attributes
Show child attributes
⌘I
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"
}
]
}