请输入
菜单

生成图像(OpenAI)

使用文本提示词生成图片,返回图片地址或 Base64 数据。

请求

项目 说明
方法 POST
路径 /v1/images/generations
网关地址 https://ailink.nativex.com
认证 Authorization: Bearer sk-xxxx,替换为你的 API Key
请求格式 application/json

示例中的 MODEL_ID 请替换为「模型广场」中支持本接口的模型名称。模型、参数支持范围与可用权限以当前账户为准。

参数说明

参数 位置 类型 必填 说明
model Body string 是 支持 Images 接口的模型,建议显式指定
prompt Body string 是 图片描述
n Body integer 否 生成张数,建议先使用 1;上限随模型而异,dall-e-3 仅支持 1
size Body string 否 尺寸;例如 1024x1024,支持值由模型决定
quality Body string 否 画质档位;不同模型的可选值不同
response_format Body string 否 url 或 b64_json,是否可选取决于模型
background Body string 否 支持的 GPT Image 模型可用 transparent、opaque 或 auto
output_format Body string 否 支持的模型可选择 png、jpeg 或 webp
不要将中文翻译后的参数值发给接口;例如透明背景值是 transparent。尺寸、画质、格式必须与所选模型匹配。

调用示例

curl -X POST 'https://ailink.nativex.com/v1/images/generations' \
  -H 'Authorization: Bearer sk-xxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "MODEL_ID",
  "prompt": "一只橘猫坐在窗边,水彩插画风格",
  "n": 1
}'

响应

以下为便于阅读的简化结构示例,标识、链接、文本及用量均为示意值。

{
  "created": 0,
  "data": [
    {
      "url": "https://example.com/generated.png"
    }
  ]
}
字段或结果 说明
data[].url 临时图片地址,如有则及时下载
data[].b64_json 如返回此字段,解码后保存图片
usage 部分模型返回的用量信息

错误处理

非成功响应时,先查看 HTTP 状态和错误正文。检查 API Key、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。

最近修改: 2026-10-28