# "Tạo hình ảnh gemini-2.5-flash-image"

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

> 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:
  /v1beta/models/gemini-2.5-flash-image:generateContent:
    post:
      summary: Tạo hình ảnh gemini-2.5-flash-image
      deprecated: false
      description: >-
        Tài liệu chính thức:
        https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn#gemini-image-editing
      operationId: gemini_v1beta_2_5_flash_image_generate_content
      tags:
        - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc
        - Gemini v1beta
      parameters:
        - name: key
          in: query
          description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)'
          required: true
          example: '{{YOUR_API_KEY}}'
          schema:
            type: string
        - name: Content-Type
          in: header
          description: Loại nội dung của phần thân yêu cầu, thường là application/json
          required: true
          example: application/json
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - contents
                - generationConfig
              properties:
                contents:
                  type: array
                  items:
                    type: object
                    properties:
                      parts:
                        type: array
                        items:
                          type: object
                          properties:
                            inline_data:
                              type: object
                              required:
                                - mime_type
                                - data
                              properties:
                                data:
                                  type: string
                                  description: >-
                                    Dữ liệu phương tiện được mã hóa Base64
                                    (không có tiền tố URI data:)
                                mime_type:
                                  type: string
                                  description: >-
                                    Loại MIME của phương tiện, ví dụ: image/png,
                                    image/jpeg, audio/wav
                              description: >-
                                Dữ liệu phương tiện nội tuyến (hình ảnh/âm
                                thanh/v.v.)
                              x-apifox-orders:
                                - data
                                - mime_type
                              x-apidog-orders:
                                - data
                                - mime_type
                            text:
                              type: string
                              description: Vui lòng cung cấp nội dung văn bản cần dịch.
                          x-apifox-orders:
                            - inline_data
                            - text
                          x-apidog-orders:
                            - inline_data
                            - text
                        description: >-
                          Danh sách các phần nội dung; có thể bao gồm văn bản,
                          inline_data / inlineData, v.v.
                    x-apifox-orders:
                      - parts
                    x-apidog-orders:
                      - parts
                  description: >-
                    Danh sách nội dung cuộc hội thoại; mỗi mục gồm các phần (văn
                    bản/hình ảnh/v.v.)
                generationConfig:
                  type: object
                  required:
                    - responseModalities
                    - imageConfig
                  properties:
                    imageConfig:
                      type: object
                      required:
                        - aspectRatio
                      properties:
                        aspectRatio:
                          type: string
                          description: >-
                            Tỷ lệ khung hình của ảnh đầu ra, ví dụ: 1:1, 16:9,
                            9:16
                      description: Cấu hình đầu ra hình ảnh
                      x-apifox-orders:
                        - aspectRatio
                      x-apidog-orders:
                        - aspectRatio
                    responseModalities:
                      type: array
                      items:
                        type: string
                      description: >-
                        Phương thức phản hồi, ví dụ: ["TEXT"], ["IMAGE"],
                        ["AUDIO"]
                  description: >-
                    Cấu hình tạo sinh (phương thức, kích thước hình ảnh, giọng
                    nói, v.v.)
                  x-apifox-orders:
                    - imageConfig
                    - responseModalities
                  x-apidog-orders:
                    - imageConfig
                    - responseModalities
                response_format:
                  type: string
                  description: >-
                    Điền vào url và trả về url; nếu không, hãy điền base64 mặc
                    định.
              refName: PostV1betaModelsGemini25FlashImageGenerateContentRequest
              x-apifox-orders:
                - contents
                - generationConfig
                - response_format
              x-apidog-orders:
                - contents
                - generationConfig
                - response_format
            examples:
              gemini_25_flash_image_single:
                value:
                  contents:
                    - parts:
                        - text: >-
                            'Chào, đây là ảnh của tôi. Bạn có thể thêm một con
                            lạc đà không bướu bên cạnh tôi không
                        - inline_data:
                            data: iVBORw0KGgoAAAANSUhEUgAABAAAAAKoCAIA...
                            mime_type: image/jpeg
                      role: user
                  generationConfig:
                    imageConfig:
                      aspectRatio: '16:9'
                    responseModalities:
                      - Vui lòng cung cấp nội dung tài liệu cần dịch.
                      - HÌNH ẢNH
                summary: gemini_25_flash_image_single
                description: >-
                  Tính năng tạo ảnh gemini-2.5-flash-image kiểm soát tỷ lệ khung
                  hình
              gemini_25_flash_image_single_2:
                value:
                  contents:
                    - parts:
                        - text: >-
                            'Chào, đây là ảnh của tôi. Bạn có thể thêm một con
                            lạc đà không bướu bên cạnh tôi không
                        - inline_data:
                            data: iVBORw0KGgoAAAANSUhEUgAABAAAAAKoCAIA...
                            mime_type: image/jpeg
                      role: user
                  generationConfig:
                    imageConfig:
                      aspectRatio: '16:9'
                    responseModalities:
                      - Vui lòng cung cấp nội dung tài liệu cần dịch.
                      - HÌNH ẢNH
                  response_format: url
                summary: gemini_25_flash_image_single_2
                description: >-
                  Tính năng tạo ảnh gemini-2.5-flash-image kiểm soát tỷ lệ khung
                  hình
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                x-apidog-orders: []
              examples:
                example:
                  summary: example
                  value:
                    id: resp_example
                    object: phản hồi
                    status: completed
          headers: {}
          x-apidog-name: ''
        '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/Trò chuyện/Gemini/Định dạng gốc
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208839-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```
