使用文本提示词生成图片,返回图片地址或 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、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。