Skip to main content
POST
/
images
/
generations
Create image generation
curl --request POST \
  --url https://dimilinks.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "model": "gpt-image-2",
  "n": 1,
  "size": "<string>",
  "output_format": "<string>",
  "output_compression": 123,
  "background": "<string>",
  "moderation": "<string>",
  "wait_for_result": true,
  "image_urls": "<string>",
  "mask_url": "<string>",
  "response_format": "<string>",
  "user": "<string>"
}
'
{
  "task_id": "img_xxx",
  "data": [],
  "created": 1777080000
}
gpt-image-2 是 DimiLinks 的图片生成模型，支持文生图与图生图。可以通过 image_urls 字段携带参考图，最多 9 张。
推荐加上 ?async=true。同步模式会等图片完成后才返回，更容易被网关或客户端超时打断。

​
请求地址

POST https://dimilinks.com/v1/images/generations?async=true
Content-Type: application/json
Authorization: Bearer <DIMILINKS_API_KEY>

​
文生图示例

curl "https://dimilinks.com/v1/images/generations?async=true" \
  -H "Authorization: Bearer $DIMILINKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张赛博朋克风格的猫咪海报，霓虹灯，电影感",
    "n": 1,
    "size": "16:9",
    "resolution": "2k",
    "output_format": "png"
  }'

​
图生图示例

curl "https://dimilinks.com/v1/images/generations?async=true" \
  -H "Authorization: Bearer $DIMILINKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "保持人物主体一致，改成海边日落电影写真风格",
    "n": 1,
    "size": "16:9",
    "resolution": "4k",
    "image_urls": [
      "https://example.com/reference.png"
    ]
  }'

​
异步响应

{
  "created": 1777080000,
  "task_id": "img_xxx",
  "data": []
}
拿到 task_id 后，请调用 Retrieve image task 查询结果。

​
同步响应

同步模式会在图片完成后返回： 
{
  "created": 1777080000,
  "task_id": "img_xxx",
  "data": [
    {
      "url": "/p/img/img_xxx/0?exp=1777166400000&sig=...",
      "file_id": "file_xxx"
    }
  ]
}

​
结果字段说明

data[].url 不一定是公网图片链接，请同时兼容三种形式：
  • /p/img/...：相对路径，展示或下载前补成 https://dimilinks.com/p/img/...。该路径不需要 Bearer，URL 自带签名和过期时间。
  • https://...：完整图片链接，可直接请求或展示。
  • data:image/...;base64,...：Data URL，字符串本身就是图片内容。网页可直接作为 <img src>；服务端脚本保存文件时需要先解码 base64。

​
参数

参数类型默认值说明
modelstringgpt-image-2模型名称。
promptstring必填生图或编辑提示词。
ninteger1单次生成数量。1k 档固定为 1，2k / 4k 档最多 4。
sizestring1024x1024比例如 1:1、16:9，或具体像素 WxH（例如 3840x2160）。
resolutionstring空清晰度档位：1k / 2k / 4k。
output_formatstring空输出格式：png / jpeg / webp。
output_compressioninteger空输出压缩质量，配合 jpeg 或 webp 使用。
backgroundstring空背景偏好：auto / transparent / opaque。
moderationstring空内容审核强度：auto / low。
userstring空调用方用户标识，便于审计。
wait_for_resultbooleantrue传 false 进入异步提交。
image_urlsstring | array | object空JSON 参考图字段，最多 9 张。
mask_urlstring空局部重绘遮罩，需配合至少 1 张参考图。
response_formatstring空传 b64_json 时返回结果直接是 base64；不建议默认开启。

​
开启异步的方式

任一方式命中即可进入异步模式：
  • 查询参数：?async=true
  • 查询参数：?wait_for_result=false
  • 请求头：Prefer: respond-async
  • 请求体："wait_for_result": false

​
参考图格式

推荐使用 image_urls： 
{
  "image_urls": [
    "https://example.com/ref.png",
    "data:image/png;base64,iVBORw0KGgo..."
  ]
}
也兼容 reference_images、images、image、image_url、input_image 和 input_images。

​
参考图限制

  • 同一次请求最多 9 张参考图。
  • 单张参考图最大 20 MB。
  • 支持 HTTP(S) URL、Data URL 和纯 base64。
  • 浏览器 blob: URL 不能直接传入，请先上传到你的服务端或转成 Data URL。

​
清晰度档位的能力差异

档位单次最多 n典型耗时说明
1k1约 60 秒起步档，适合预览或低成本批量。
2k4约 120 秒推荐档，适合大多数业务出图。
4k4约 180 秒高保真档，部分极端比例（如 21:9）也可用。
具体单价以控制台「价格」页为准；不同档位的价格独立计算。

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
async
boolean

Set to true to submit an async image task.

​
wait_for_result
boolean

Set to false to submit an async image task.

Body

application/json
​
prompt
string
required
​
model
string
default:gpt-image-2
​
n
integer
default:1

1k resolution allows n=1 only; 2k and 4k allow up to 4.

Required range: 1 <= x <= 4
​
size
string
Examples:

"1:1"

"16:9"

"3840x2160"

​
resolution
enum<string>
Available options:
1k,
2k,
4k
​
output_format
string
Examples:

"png"

"jpeg"

"webp"

​
output_compression
integer
​
background
string
Examples:

"auto"

"transparent"

"opaque"

​
moderation
string
Examples:

"auto"

"low"

​
wait_for_result
boolean
​
image_urls
​
mask_url
string
​
response_format
string
Example:

"b64_json"

​
user
string

Response

Image generation result or async submission

​
task_id
string
required
Example:

"img_xxx"

​
data
object[]
required
Example:
[]
​
created
integer
Example:

1777080000