# "Tạo gpt-image-2.5"

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

> 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:
  /v1/images/generations:
    post:
      summary: Tạo gpt-image-2.5
      deprecated: false
      description: >-
        Với một lời nhắc, mô hình sẽ trả về một hoặc nhiều phần hoàn thành được
        dự đoán, đồng thời cũng có thể trả về xác suất của các mã từ thay thế
        tại mỗi vị trí.


        Tạo các phần hoàn thành cho lời nhắc và các tham số được cung cấp.


        Tài liệu chính thức:
        https://platform.openai.com/docs/api-reference/images/create
      operationId: post-v1-images-generations
      tags:
        - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1
        - API tạo ảnh từ văn bản/GPT Image-1
      parameters:
        - name: Content-Type
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
        - name: Accept
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
        - name: Authorization
          in: header
          description: ''
          required: false
          example: Bearer {{YOUR_API_KEY}}
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - prompt
                - model
                - 'n'
              properties:
                background:
                  type: string
                  enum:
                    - auto
                    - opaque
                    - transparent
                  description: |-
                    Nền
                    Các tùy chọn: auto (mặc định), opaque, transparent
                    Khi transparent, định dạng phải là png hoặc webp
                format:
                  type: string
                  description: >-
                    Định dạng hình ảnh

                    Các tùy chọn: png, jpeg, webp

                    Sử dụng png hoặc webp cho nền trong suốt.

                    (Tên trường chính thức là output_format, nhưng cổng này dùng
                    nhất quán format như trong bảng điều khiển gỡ lỗi
                    gpt-image-2.)
                model:
                  type: string
                  enum:
                    - gpt-image-2.5-flare
                    - gpt-image-2.5-sunburst
                  enumDetails:
                    - value: gpt-image-2.5-flare
                      displayName: Flare
                    - value: gpt-image-2.5-sunburst
                      displayName: Biểu đồ tia nắng
                  description: >-
                    Tên mô hình

                    gpt-image-2.5-flare     Nhanh hơn, phù hợp cho việc tạo nội
                    dung hằng ngày hoặc với mức độ đồng thời cao

                    gpt-image-2.5-sunburst  Độ chính xác cao hơn, phù hợp cho
                    việc tinh chỉnh và sản xuất nội dung sáng tạo
                moderation:
                  type: string
                  enum:
                    - auto
                    - low
                  description: |-
                    Mức độ nghiêm ngặt của kiểm duyệt nội dung
                    Các tùy chọn: auto (mặc định), low
                'n':
                  type: integer
                  description: >-
                    Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến
                    10. Mặc định là 1 nếu không được cung cấp.
                prompt:
                  type: string
                  description: >-
                    Mô tả bằng văn bản về hình ảnh mong muốn. Độ dài tối đa là
                    1000 ký tự.
                quality:
                  type: string
                  description: >-
                    Chất lượng hình ảnh

                    Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định)


                    So với gpt-image-2, xhigh và max là các tùy chọn mới.

                    low phù hợp với bản nháp; xhigh / max cung cấp nhiều chi
                    tiết hơn nhưng có độ trễ và chi phí cao hơn.
                response_format:
                  type: string
                  enum:
                    - url
                    - b64_json
                  enumDetails:
                    - value: url
                    - value: b64_json
                size:
                  type: string
                  description: >-
                    Kích thước hình ảnh

                    1024x1024      Vuông

                    1536x1024      Ngang

                    1024x1536      Dọc

                    2048x2048      Vuông 2K

                    2048x1152      Ngang 2K

                    3840x2160      Ngang 4K

                    2160x3840      Dọc 4K

                    auto           Mặc định


                    Các quy tắc giới hạn kích thước nghiêm ngặt

                    1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px

                    2. Cả chiều rộng và chiều cao phải là bội số của 16px

                    3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1

                    4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa
                    8294400


                    Các độ phân giải trên 2560x1440 được xem là các khả năng thử
                    nghiệm.
              x-apifox-orders:
                - background
                - format
                - model
                - moderation
                - 'n'
                - prompt
                - quality
                - response_format
                - size
              x-apidog-orders:
                - background
                - format
                - model
                - moderation
                - 'n'
                - prompt
                - quality
                - response_format
                - size
            examples:
              example:
                value:
                  format: webp
                  model: gpt-image-2.5-flare
                  'n': 1
                  prompt: >-
                    Ảnh tĩnh sản phẩm: bàn phím cơ màu đen nhám, ánh sáng trường
                    quay, không có chữ
                  quality: trung bình
                  response_format: url
                  size: 1536x1024
                summary: example
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                required:
                  - created
                  - data
                properties:
                  created:
                    type: integer
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                      x-apifox-orders:
                        - url
                      x-apidog-orders:
                        - url
                x-apifox-orders:
                  - created
                  - data
                x-apidog-orders:
                  - created
                  - data
              examples:
                example:
                  summary: example
                  value:
                    created: 1773100000
                    data:
                      - url: >-
                          https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.webp
          headers: {}
          x-apidog-name: ''
      security: []
      x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208885-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```
