V-API

图像生成 gpt-image-1

POST

/v1/images/generations

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

prompt

string

提示词

必需

所需图像的文本描述。最大长度为 1000 个字符，最大长度为 4000 个字符。

model

string

模型名称

必需

gpt-image-1

number | null

生成数量

可选

（默认值 1）一次性生成的图片数量：支持1～10. 数量越多生成速度越慢，建议通过多次请求速度更快。

size

enum<string> | enum<null>

图片尺寸

可选

生成的图片尺寸。

枚举值:

auto1024x10241024x15361536x1024

默认值:

auto

output_format

enum<string> | enum<null>

输出格式

可选

指定生成的图片格式。

枚举值:

pngjpegwebp

默认值:

png

background

enum<string> | enum<null>

背景透明度

可选

允许设置生成图像背景的透明度。仅输出格式为 png、webp 时支持该参数。

枚举值:

transparentopaqueauto

默认值:

auto

output_compression

integer | null

压缩级别

可选

图片质量压缩级别，仅支持webp和jpeg图片

moderation

enum<string> | enum<null>

图片审查级别

可选

控制生成的图像的内容审核级别。

枚举值:

autolow

默认值:

auto

quality

enum<string> | enum<null>

图片质量

可选

总共三种品质，默认 auto 指向high

枚举值:

autohighmediumlow

user

string | null

用户

可选

代表您的最终用户的唯一标识符，可以帮助 OpenAI 监控和检测滥用行为。了解更多

示例

{
    "model": "gpt-image-1",
    "prompt": "一幅详细的图像描绘了一个广阔的石器时代城市，城市中高耸的摩天大楼由巨石和骨头构成。这里热闹非凡，各种性别和种族的人们共同展现出原始人和原始女性的统一外貌。他们身穿商务服装，与史前背景形成鲜明对比。化石化的塔楼点缀着石质天际线，而人们则保留着原始的设计，身上披着毛皮，搭配现代的西装和领带。形成了现代生活与史前时代的美丽融合。",
    "n": 1,
    "quality":"medium",
    "size": "1024x1024"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.gpt.ge/v1/images/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "gpt-image-1",
    "prompt": "一幅详细的图像描绘了一个广阔的石器时代城市，城市中高耸的摩天大楼由巨石和骨头构成。这里热闹非凡，各种性别和种族的人们共同展现出原始人和原始女性的统一外貌。他们身穿商务服装，与史前背景形成鲜明对比。化石化的塔楼点缀着石质天际线，而人们则保留着原始的设计，身上披着毛皮，搭配现代的西装和领带。形成了现代生活与史前时代的美丽融合。",
    "n": 1,
    "quality":"medium",
    "size": "1024x1024"
}'

返回响应

🟢200成功

application/json

Body

created

integer

必需

data

array [object {1}]

必需

b64_json

string

可选

usage

object

必需

input_tokens

integer

必需

input_tokens_details

object

必需

output_tokens

integer

必需

total_tokens

integer

必需

示例

{
    "created": 1745984918,
    "data": [
        {
            "b64_json": "iVBORw0KGgoAAAANSUhEUgAABAAAAAYACAI..."
        }
    ],
    "usage": {
        "input_tokens": 8,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 8
        },
        "output_tokens": 408,
        "total_tokens": 416
    }
}

修改于 2025-05-15 03:15:44

图像生成 dall-e-2、dall-e-3

图像编辑 gpt-image-1