> ## 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.

# 產生一張 Bria 圖像

> 使用 CometAPI Bria POST /bria/text-to-image，透過文字搭配增強功能與彈性的長寬比，產生 1MP 擬真圖像。

從純文字 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`。

<Note>
  CometAPI 會代理 Bria 的能力，而不是逐欄位鏡像 Bria 的公開 API。整合時，請以本頁 API 參考與 Playground 中顯示的請求與回應格式作為唯一依據。
</Note>


## OpenAPI

````yaml api/openapi/image/bria/post-generate-image.openapi.json POST /bria/text-to-image
openapi: 3.1.0
info:
  title: Generate Image API
  version: 1.0.0
  description: >-
    Generate Bria text-to-image outputs through CometAPI. This route returns
    final image URLs directly.
servers:
  - url: https://api.cometapi.com
security:
  - bearerAuth: []
paths:
  /bria/text-to-image:
    post:
      summary: Generate Bria images
      description: >-
        Create one or more Bria images from a text prompt. For the most
        predictable first request, keep num_results at 1 and use a square aspect
        ratio.
      operationId: generate_image
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - prompt
              properties:
                prompt:
                  type: string
                  description: English text prompt for image generation.
                  example: A paper boat floating on calm water at sunrise.
                num_results:
                  type: integer
                  description: >-
                    Number of images to generate. Use 1 for the simplest
                    integration test.
                  default: 1
                aspect_ratio:
                  type: string
                  description: Requested output aspect ratio.
                  enum:
                    - '1:1'
                    - '2:3'
                    - '3:2'
                    - '3:4'
                    - '4:3'
                    - '4:5'
                    - '5:4'
                    - '9:16'
                    - '16:9'
                  default: '1:1'
                seed:
                  type: integer
                  description: Optional seed for reproducible results.
                negative_prompt:
                  type: string
                  description: Optional exclusions for the generated image.
                steps_num:
                  type: integer
                  description: Optional refinement step count.
                  default: 30
                text_guidance_scale:
                  type: integer
                  description: Optional prompt adherence setting.
                  default: 5
                medium:
                  type: string
                  description: Optional visual medium.
                  enum:
                    - photography
                    - art
                prompt_enhancement:
                  type: boolean
                  description: Optional prompt enhancement switch.
                  default: false
                enhance_image:
                  type: boolean
                  description: Optional image detail enhancement switch.
                  default: false
                prompt_content_moderation:
                  type: boolean
                  description: Optional moderation switch.
                  default: false
                ip_signal:
                  type: boolean
                  description: Optional IP warning flag.
                  default: false
                sync:
                  type: boolean
                  description: >-
                    Optional sync hint. CometAPI returns final results
                    immediately without setting this field.
                  default: false
              default:
                prompt: A paper boat floating on calm water at sunrise.
                num_results: 1
                aspect_ratio: '1:1'
            examples:
              Validated request:
                summary: Validated request
                value:
                  prompt: A paper boat floating on calm water at sunrise.
                  num_results: 1
                  aspect_ratio: '1:1'
      responses:
        '200':
          description: Image generation result.
          content:
            application/json:
              schema:
                type: object
                required:
                  - result
                properties:
                  result:
                    type: array
                    items:
                      type: object
                      required:
                        - urls
                        - seed
                        - uuid
                      properties:
                        urls:
                          type: array
                          items:
                            type: string
                        seed:
                          type: integer
                        uuid:
                          type: string
                example:
                  result:
                    - urls:
                        - https://example.com/generated.png
                      seed: 278741175
                      uuid: 27c39b06-1dfe-11f1-ad57-6ac2c454c04d_278741175
              example:
                result:
                  - urls:
                      - >-
                        https://temp.bria.ai/api/generate_image/A_paper_boat_..._seed_934469972.png
                    seed: 934469972
                    uuid: <uuid>
      x-codeSamples:
        - lang: Shell
          label: Default
          source: |
            curl https://api.cometapi.com/bria/text-to-image \
              -H "Authorization: Bearer $COMETAPI_KEY" \
              -H "Content-Type: application/json" \
              -d '{
                  "prompt": "A paper boat floating on calm water at sunrise.",
                  "num_results": 1,
                  "aspect_ratio": "1:1"
                }'
        - lang: Python
          label: Default
          source: >
            import os

            import requests


            response = requests.post(
                "https://api.cometapi.com/bria/text-to-image",
                headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
                json={
                        "prompt": "A paper boat floating on calm water at sunrise.",
                        "num_results": 1,
                        "aspect_ratio": "1:1"
                },
            )


            print(response.json())  # the route responds synchronously with
            result[].urls
        - lang: JavaScript
          label: Default
          source: >
            const response = await
            fetch("https://api.cometapi.com/bria/text-to-image", {
                method: "POST",
                headers: {
                    Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
                    "Content-Type": "application/json",
                },
                body: JSON.stringify({
                        "prompt": "A paper boat floating on calm water at sunrise.",
                        "num_results": 1,
                        "aspect_ratio": "1:1"
                    }),
            });


            console.log(await response.json()); // the route responds
            synchronously with result[].urls
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer token authentication. Use your CometAPI key.

````