跳转至

图片生成

POST /v1/images/generations

请参阅 快速上手指南 获取您的 API 密钥。

$YOUR_API_KEY 替换为你在上一步生成的实际 API 密钥。
请确保将 $MODEL_ID 替换为要使用的模型 ID。

请求体


prompt 字符串 必填
本次请求使用模型的 Model ID。


model 字符串 必填

用于图片生成的模型ID。


n 整数 可选 默认值为 1

同时生成的图片数量。请注意,不同模型支持的数量可能有所不同。


size 字符串 可选 默认值为 1024x1024

生成图像的宽高像素,要求介于 [512 x 512, 2048 x 2048] 之间。

推荐可选的宽高:

  • 1024x1024 (1:1)
  • 864x1152 (3:4)
  • 1152x864 (4:3)
  • 1280x720 (16:9)
  • 720x1280 (9:16)

响应参数


model 字符串

本次请求使用的模型 ID(模型名称-版本)。


created 整数

本次请求创建时间的 Unix 时间戳(秒)。


data 列表

输出的图像信息,Base64格式。


usage 对象

本次请求的用量信息。


generated_images 整数

模型生成的图片张数。
output_tokens 整数

模型生成的图片所用的 token 数量。 计算公式为:长*宽/256,四舍五入取整。
total_tokens 整数

本次请求消耗的总 token 数量。 说明:由于输入不进行 token 计算,故 total_tokensoutput_tokens 一致。

error 对象

本次请求,如发生错误,对应的错误信息。


code 字符串

请参见错误码。
message 字符串

错误提示信息。