创建图片（generations）

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Authorization

string

可选

示例值:

Bearer {{YOUR_API_KEY}}

Body 参数application/json

model

string

枚举值

必需

prompt

string

必需

n

integer

必需

response_format

string

必需

枚举值 url b64_json oss_url 其中url有效时间为24小时 oss_url有效时间为7天

size

string

必需

gpt-image-1 ，必须为 1024x1024 、 1536x1024 （横向）、 1024x1536 （纵向）或 auto （默认值）

background

string

必需

此参数仅支持 gpt-image-1 。必须是以下之一： transparent 、 opaque 或 auto （默认值）。使用 auto 时，模型将自动确定图像的最佳背景。

quality

string

必需

auto （默认值）将自动为给定模型选择最佳质量。 gpt-image-1 支持 high 、 medium 、 low 。

moderation

string

必需

控制 gpt-image-1 生成的图像的内容审核级别。必须设置为 low （用于限制较少的过滤）或 auto （默认值）。

示例

{
  "model": "gpt-image-1", // 枚举值
  "prompt": "3D魔童哪吒 c4d 搬砖 很开心， 很快乐， 精神抖擞， 背景是数不清的敖丙虚化 视觉冲击力强 大师构图 色彩鲜艳丰富 吸引人 背景用黄金色艺术字写着“搬砖挣钱” 冷暖色对比",
  "n": 1,
  "response_format": "url", // 枚举值 url b64_json

  "size": "1536x1024", // gpt-image-1 ，必须为 1024x1024 、 1536x1024 （横向）、 1024x1536 （纵向）或 auto （默认值）
  "background": "auto", // 此参数仅支持 gpt-image-1 。必须是以下之一： transparent 、 opaque 或 auto （默认值）。使用 auto 时，模型将自动确定图像的最佳背景。
  "quality": "auto", // auto （默认值）将自动为给定模型选择最佳质量。 gpt-image-1 支持 high 、 medium 、 low 。
  "moderation": "low" // 控制 gpt-image-1 生成的图像的内容审核级别。必须设置为 low （用于限制较少的过滤）或 auto （默认值）。
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.chatfire.cn/v1/images/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "gpt-image-1", // 枚举值
  "prompt": "3D魔童哪吒 c4d 搬砖 很开心， 很快乐， 精神抖擞， 背景是数不清的敖丙虚化 视觉冲击力强 大师构图 色彩鲜艳丰富 吸引人 背景用黄金色艺术字写着“搬砖挣钱” 冷暖色对比",
  "n": 1,
  "response_format": "url", // 枚举值 url b64_json

  "size": "1536x1024", // gpt-image-1 ，必须为 1024x1024 、 1536x1024 （横向）、 1024x1536 （纵向）或 auto （默认值）
  "background": "auto", // 此参数仅支持 gpt-image-1 。必须是以下之一： transparent 、 opaque 或 auto （默认值）。使用 auto 时，模型将自动确定图像的最佳背景。
  "quality": "auto", // auto （默认值）将自动为给定模型选择最佳质量。 gpt-image-1 支持 high 、 medium 、 low 。
  "moderation": "low" // 控制 gpt-image-1 生成的图像的内容审核级别。必须设置为 low （用于限制较少的过滤）或 auto （默认值）。
}'

返回响应

🟢200成功

application/json

Body

data

array [object {2}]

必需

url

string

可选

revised_prompt

string

可选

created

integer

必需

usage

null

必需

示例

{"data":[{"url":"","b64_json":"iVBORw0KGgoAAAANSUhEUgAABgAAAAQACAIAAACoEwUVAAEfdGNhQlgAAR90anVtYgAAAB5qdW1kYzJwYQARABCAAACqADibcQNjMnBhAAAANw9qdW1iAAAAR2p1bWRjMm1hABEAEIAAAKoAOJtxA3VybjpjMnBhOjM4NjNmMjMxLWM4N2ItNGIxMi1iMGVmLTRiZjNkMDk5YjAzYQAAAAHhanVtYgAAAClqdW1kYzJhcwARABCAAACqADibcQNjMnBhLmFzc2VydGlvbnMAAAABBWp1bWIAAAApanVtZGNib3IAEQAQgAAAqgA4m3EDYzJwYS5hY3Rpb25zLnYyAAAAANRjYm9yoWdhY3Rpb25zgqNmYWN0aW9ubGMycGEuY3JlYXRlZG1zb2Z0d2FyZUFnZW50v2RuYW1lZkdQVC00b/9xZGlnaXRhbFNvdXJjZVR5cGV4Rmh0dHA6Ly9jdi5pcHRjLm9yZy9uZXdzY29kZXMvZGlnaXRhbHNvdXJjZXR5cGUvdHJhaW5lZEFsZ29yaXRobWljTWVkaWGiZmFjdGlvbm5jMnBhLmNvbnZlcnRlZG1zb2Z0d2FyZUFnZW50v2RuYW1lak9wZW5BSSBBUEn/AAAAq2p1bWIAAAAoanVtZGNib3IAEQAQgAAAqgA4m3EDYzJwYS5oYXNoLmRhdGEAAAAAe2Nib3KlamV4Y2x1c2lvbnOBomVzdGFydBghZmxlbmd0aBk3QWRuYW1lbmp1bWJmIG1hbmlmZXN0Y2FsZ2ZzaGEyNTZkaGFzaFggJ+rt8pOBRXW8fcQCNsh75tpQ7vREEfShLZ9qDHJPmadjcGFkSAAAAAAAAAAAAAAB4mp1bWIAAAAnanVtZGMyY2wAEQAQgAAAqgA4m3EDYzJwYS5jbGFpbS52MgAAAAGzY2JvcqZqaW5zdGFuY2VJRHgseG1wOmlpZDowZTViZjNmNy00YTZjLTQ5ODMtOWEyNS0xNDEyODc3MTYwMzR0Y2xhaW1fZ2VuZXJhdG9yX2luZm+/ZG5hbWVjQVBJb29yZy5jYWkuYzJwYV9yc2YwLjQ5LjP/aXNpZ25hdHVyZXhNc2VsZiNqdW1iZj0vYzJwYS91cm46YzJwYTozODYzZjIzMS1jODdiLTRiMTItYjBlZi00YmYzZDA5OWIwM2EvYzJwYS5zaWduYXR1cmVyY3Jl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