# "Seedream 5.0 Pro"

Nguồn: https://docs.openaihub.net/api-45208895/

> API origin: `https://api.openaihub.net`. Chọn đúng nhóm API và model. Thông số dưới đây là bản tham chiếu kỹ thuật; chưa phải kết quả kiểm thử từng endpoint bằng tài khoản của bạn.


## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v3/images/generations:
    post:
      summary: Seedream 5.0 Pro
      deprecated: false
      description: ''
      operationId: post-api-v3-images-generations
      tags:
        - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Doubao
        - volc
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - prompt
              properties:
                guidance_scale:
                  type: number
                  description: Mức độ tuân thủ lời nhắc; phạm vi [1, 10]
                image:
                  oneOf:
                    - type: string
                      format: uri
                    - type: array
                      items:
                        type: string
                        format: uri
                  description: >-
                    Tham chiếu (chính thức). Một chuỗi URL đơn hoặc mảng URL
                    (chỉnh sửa tương tác / I2I, tối đa khoảng 10)
                images:
                  oneOf:
                    - type: string
                      format: uri
                    - type: array
                      items:
                        type: string
                        format: uri
                  description: >-
                    trường tương thích; cổng kết nối chuẩn hóa thành image. Dùng
                    trường này hoặc image
                model:
                  type: string
                  enum:
                    - doubao-seedream-5-0-pro-260628
                  description: Tên mô hình
                'n':
                  type: integer
                  description: Số lượng hình ảnh; Pro thường là 1
                optimize_prompt_options:
                  type: object
                  required:
                    - mode
                  properties:
                    mode:
                      type: string
                      enum:
                        - standard
                        - fast
                      description: chế độ tối ưu hóa
                  description: cài đặt tối ưu hóa lời nhắc
                  x-apifox-orders:
                    - mode
                  x-apidog-orders:
                    - mode
                output_format:
                  type: string
                  enum:
                    - jpeg
                    - png
                  description: định dạng tệp hình ảnh
                prompt:
                  type: string
                  description: lời nhắc tạo / chỉnh sửa
                response_format:
                  type: string
                  enum:
                    - url
                    - b64_json
                  description: cấu trúc phản hồi
                seed:
                  type: integer
                  description: Hạt giống ngẫu nhiên, phạm vi [-1, 2147483647], mặc định -1
                size:
                  type: string
                  enum:
                    - 1K
                    - 2K
                    - 1024x1024
                    - 1152x864
                    - 864x1152
                    - 1424x800
                    - 800x1424
                    - 1248x832
                    - 832x1248
                    - 1568x672
                    - 2048x2048
                    - 2368x1776
                    - 1776x2368
                    - 2816x1584
                    - 1584x2816
                    - 2496x1664
                    - 1664x2496
                    - 3136x1344
                  description: >-
                    Mức độ phân giải hoặc số pixel. Thường là 1K/2K; cũng có thể
                    là 1024x1024, 2048x2048, 2816x1584. Nếu để trống, chi phí sẽ
                    được tính theo mức cao hơn
                watermark:
                  type: boolean
                  description: Có thêm hình mờ hay không
              x-apifox-orders:
                - guidance_scale
                - image
                - images
                - model
                - 'n'
                - optimize_prompt_options
                - output_format
                - prompt
                - response_format
                - seed
                - size
                - watermark
              x-apidog-orders:
                - guidance_scale
                - image
                - images
                - model
                - 'n'
                - optimize_prompt_options
                - output_format
                - prompt
                - response_format
                - seed
                - size
                - watermark
            examples:
              example:
                value:
                  model: doubao-seedream-5-0-pro-260628
                  prompt: Một con mèo
                  response_format: url
                  size: 2K
                  watermark: false
                summary: example
      responses:
        '200':
          description: Được
          content:
            application/json:
              schema:
                type: object
                x-apidog-orders: []
              examples:
                example:
                  summary: example
                  value:
                    code: 0
                    data:
                      task_id: task_example_001
                    message: thành công
          headers: {}
          x-apidog-name: Được
        '400':
          description: Yêu cầu không hợp lệ hoặc xác thực thất bại
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - message
                      - type
                    properties:
                      message:
                        type: string
                        description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
                      type:
                        type: string
                        description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
                        examples:
                          - new_api_error
                    x-apifox-orders:
                      - message
                      - type
                    x-apidog-orders:
                      - message
                      - type
                refName: NewApiError
                x-apifox-orders:
                  - error
                x-apidog-orders:
                  - error
              examples:
                example:
                  summary: example
                  value:
                    error:
                      message: >-
                        Yêu cầu không hợp lệ (mã yêu cầu:
                        20260805120000123456789AbCdEfGh)
                      type: new_api_error
          headers: {}
          x-apidog-name: Yêu cầu không hợp lệ hoặc xác thực thất bại
        '401':
          description: Khóa API bị thiếu hoặc không hợp lệ
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - message
                      - type
                    properties:
                      message:
                        type: string
                        description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
                      type:
                        type: string
                        description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
                        examples:
                          - new_api_error
                    x-apifox-orders:
                      - message
                      - type
                    x-apidog-orders:
                      - message
                      - type
                refName: NewApiError
                x-apifox-orders:
                  - error
                x-apidog-orders:
                  - error
              examples:
                example:
                  summary: example
                  value:
                    error:
                      message: >-
                        Mã thông báo không hợp lệ (request id:
                        20260805120000123456789AbCdEfGh)
                      type: new_api_error
          headers: {}
          x-apidog-name: Khóa API bị thiếu hoặc không hợp lệ
      security: []
      x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Doubao
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208895-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```