文生图
接口概述
根据文本提示词生成图片,按张计费。统一使用 OpenAI Images 风格的扁平请求体,调用不同模型时参数保持一致。
接口地址
POST https://openai.jw-info.com/v1/images/generations
请求头
| 请求头 | 是否必填 | 说明 |
|---|---|---|
| Content-Type | 是 | application/json |
| Authorization | 是 | Bearer {API_KEY},或 x-api-key |
请求参数
| 参数名 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | - | 图像模型名,见模型广场 |
| prompt | string | 是 | - | 画面描述。建议不超过 600 英文单词或 300 汉字 |
| size | string | 否 | 模型默认值 | 输出尺寸,宽x高(如 1024x1024)或预设档位(2K/4K) |
| n | integer | 否 | 1 | 生成张数(部分模型上限 6) |
| response_format | string | 否 | url | url 返回下载链接,b64_json 返回 Base64 |
| output_format | string | 否 | jpeg | 输出格式,部分模型支持 png |
| image | string / array | 否 | - | 参考图(图生图/多图融合),最多 14 张 |
| watermark | boolean | 否 | false | 是否加水印(默认不加) |
计费档位与 size 有关:部分模型按输出像素分档(如 ≤261 万像素 ¥0.3/张,超出 ¥0.6/张),缺省按高档收。
请求示例
curl https://openai.jw-info.com/v1/images/generations \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-image-2.0-pro",
"prompt": "一只白色猫咪坐在书桌上,阳光从窗户照进来",
"size": "1024x1024"
}'
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
| data[].url | string | 图片下载地址(有效期以服务返回为准,请及时转存) |
| data[].b64_json | string | response_format=b64_json 时的 Base64 图片 |
| usage | object | 部分模型返回的用量信息 |
本次扣费可在控制台「费用中心」查看。
响应示例
{
"created": 1770000000,
"data": [ { "url": "https://cdn.example.com/out/1.png" } ]
}