Bỏ qua để đến nội dung

Tạo hình ảnh

Xem Markdownllms.txt

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: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/v1/images/generations:
post:
summary: Tạo hình ảnh
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: v1_images_generations
tags:
- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Grok
- 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/Grok
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208887-run
components:
schemas: {}
securitySchemes: {}
servers:
- url: https://api.openaihub.net
description: Prod Env
security: []