メインコンテンツへスキップ
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"
    }
  ]
}
プレーンテキストのプロンプトから、商用利用に安全な画像を生成します。CometAPI での最初のリクエストでは、prompt を送信し、num_results は 1 に保ち、必要な最終レイアウトがすでに分かっている場合を除き、aspect_ratio: "1:1" から始めてください。

​
このルートを使う場面

  • 1回の呼び出しで完成した画像が欲しい
  • マスク、画像入力、タスクのポーリングは不要
  • CometAPI で運用しやすい、フォトリアルな Bria の手段が欲しい

​
まずはこのリクエストから始める

  • プロンプトは短く、具体的にする
  • 最初のリクエストでは num_results: 1 を使用する
  • 出力先のレイアウトがすでに確定している場合を除き、aspect_ratio: "1:1" から始める
  • 長期保存が必要な場合は、返却された URL をすぐにダウンロードする

​
CometAPI でのレスポンス動作

Bria の公式ドキュメントでは、より広い生成パイプラインが説明され、非同期のステータスフローについても触れられています。CometAPI では、このルートは簡略化された JSON リクエストを使用し、request_id と status_url ではなく、最終的な result 配列を即座に返します。
CometAPI は Bria の公開 API を項目ごとにそのまま再現するのではなく、Bria の機能をプロキシしています。統合の正確な基準として、このページの 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[]
必須