Skip to main content
POST
cURL
從純文字 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[]
必填