Create image generation
curl --request POST \
--url https://api-direct.dimilinks.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "<string>",
"model": "gpt-image-2",
"n": 1,
"size": "1:1",
"output_format": "png",
"output_compression": 123,
"background": "auto",
"moderation": "auto",
"wait_for_result": true,
"image_urls": "<string>",
"mask_url": "<string>",
"response_format": "b64_json",
"user": "<string>"
}
'import requests
url = "https://api-direct.dimilinks.com/v1/images/generations"
payload = {
"prompt": "<string>",
"model": "gpt-image-2",
"n": 1,
"size": "1:1",
"output_format": "png",
"output_compression": 123,
"background": "auto",
"moderation": "auto",
"wait_for_result": True,
"image_urls": "<string>",
"mask_url": "<string>",
"response_format": "b64_json",
"user": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
prompt: '<string>',
model: 'gpt-image-2',
n: 1,
size: '1:1',
output_format: 'png',
output_compression: 123,
background: 'auto',
moderation: 'auto',
wait_for_result: true,
image_urls: '<string>',
mask_url: '<string>',
response_format: 'b64_json',
user: '<string>'
})
};
fetch('https://api-direct.dimilinks.com/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-direct.dimilinks.com/v1/images/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'prompt' => '<string>',
'model' => 'gpt-image-2',
'n' => 1,
'size' => '1:1',
'output_format' => 'png',
'output_compression' => 123,
'background' => 'auto',
'moderation' => 'auto',
'wait_for_result' => true,
'image_urls' => '<string>',
'mask_url' => '<string>',
'response_format' => 'b64_json',
'user' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-direct.dimilinks.com/v1/images/generations"
payload := strings.NewReader("{\n \"prompt\": \"<string>\",\n \"model\": \"gpt-image-2\",\n \"n\": 1,\n \"size\": \"1:1\",\n \"output_format\": \"png\",\n \"output_compression\": 123,\n \"background\": \"auto\",\n \"moderation\": \"auto\",\n \"wait_for_result\": true,\n \"image_urls\": \"<string>\",\n \"mask_url\": \"<string>\",\n \"response_format\": \"b64_json\",\n \"user\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-direct.dimilinks.com/v1/images/generations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"prompt\": \"<string>\",\n \"model\": \"gpt-image-2\",\n \"n\": 1,\n \"size\": \"1:1\",\n \"output_format\": \"png\",\n \"output_compression\": 123,\n \"background\": \"auto\",\n \"moderation\": \"auto\",\n \"wait_for_result\": true,\n \"image_urls\": \"<string>\",\n \"mask_url\": \"<string>\",\n \"response_format\": \"b64_json\",\n \"user\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-direct.dimilinks.com/v1/images/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"prompt\": \"<string>\",\n \"model\": \"gpt-image-2\",\n \"n\": 1,\n \"size\": \"1:1\",\n \"output_format\": \"png\",\n \"output_compression\": 123,\n \"background\": \"auto\",\n \"moderation\": \"auto\",\n \"wait_for_result\": true,\n \"image_urls\": \"<string>\",\n \"mask_url\": \"<string>\",\n \"response_format\": \"b64_json\",\n \"user\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"task_id": "img_xxx",
"data": [],
"created": 1777080000
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"code": "<string>"
}
}图片 / gpt-image-2
Create image generation
用 gpt-image-2 生成图片,支持异步任务和 JSON 参考图。
POST
/
images
/
generations
Create image generation
curl --request POST \
--url https://api-direct.dimilinks.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "<string>",
"model": "gpt-image-2",
"n": 1,
"size": "1:1",
"output_format": "png",
"output_compression": 123,
"background": "auto",
"moderation": "auto",
"wait_for_result": true,
"image_urls": "<string>",
"mask_url": "<string>",
"response_format": "b64_json",
"user": "<string>"
}
'import requests
url = "https://api-direct.dimilinks.com/v1/images/generations"
payload = {
"prompt": "<string>",
"model": "gpt-image-2",
"n": 1,
"size": "1:1",
"output_format": "png",
"output_compression": 123,
"background": "auto",
"moderation": "auto",
"wait_for_result": True,
"image_urls": "<string>",
"mask_url": "<string>",
"response_format": "b64_json",
"user": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
prompt: '<string>',
model: 'gpt-image-2',
n: 1,
size: '1:1',
output_format: 'png',
output_compression: 123,
background: 'auto',
moderation: 'auto',
wait_for_result: true,
image_urls: '<string>',
mask_url: '<string>',
response_format: 'b64_json',
user: '<string>'
})
};
fetch('https://api-direct.dimilinks.com/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-direct.dimilinks.com/v1/images/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'prompt' => '<string>',
'model' => 'gpt-image-2',
'n' => 1,
'size' => '1:1',
'output_format' => 'png',
'output_compression' => 123,
'background' => 'auto',
'moderation' => 'auto',
'wait_for_result' => true,
'image_urls' => '<string>',
'mask_url' => '<string>',
'response_format' => 'b64_json',
'user' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api-direct.dimilinks.com/v1/images/generations"
payload := strings.NewReader("{\n \"prompt\": \"<string>\",\n \"model\": \"gpt-image-2\",\n \"n\": 1,\n \"size\": \"1:1\",\n \"output_format\": \"png\",\n \"output_compression\": 123,\n \"background\": \"auto\",\n \"moderation\": \"auto\",\n \"wait_for_result\": true,\n \"image_urls\": \"<string>\",\n \"mask_url\": \"<string>\",\n \"response_format\": \"b64_json\",\n \"user\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api-direct.dimilinks.com/v1/images/generations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"prompt\": \"<string>\",\n \"model\": \"gpt-image-2\",\n \"n\": 1,\n \"size\": \"1:1\",\n \"output_format\": \"png\",\n \"output_compression\": 123,\n \"background\": \"auto\",\n \"moderation\": \"auto\",\n \"wait_for_result\": true,\n \"image_urls\": \"<string>\",\n \"mask_url\": \"<string>\",\n \"response_format\": \"b64_json\",\n \"user\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-direct.dimilinks.com/v1/images/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"prompt\": \"<string>\",\n \"model\": \"gpt-image-2\",\n \"n\": 1,\n \"size\": \"1:1\",\n \"output_format\": \"png\",\n \"output_compression\": 123,\n \"background\": \"auto\",\n \"moderation\": \"auto\",\n \"wait_for_result\": true,\n \"image_urls\": \"<string>\",\n \"mask_url\": \"<string>\",\n \"response_format\": \"b64_json\",\n \"user\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"task_id": "img_xxx",
"data": [],
"created": 1777080000
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"code": "<string>"
}
}gpt-image-2 是 DimiLinks 的图片生成模型,支持文生图与图生图。可以通过 image_urls 字段携带参考图,最多 9 张。
推荐加上
?async=true。同步模式会等图片完成后才返回,更容易被网关或客户端超时打断。请求地址
POST https://api-direct.dimilinks.com/v1/images/generations?async=true
Content-Type: application/json
Authorization: Bearer <DIMILINKS_API_KEY>
文生图示例
curl "https://api-direct.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://api-direct.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://api-direct.dimilinks.com/p/img/...。该路径不需要 Bearer,URL 自带签名和过期时间。https://...:完整图片链接,可直接请求或展示。data:image/...;base64,...:Data URL,字符串本身就是图片内容。网页可直接作为<img src>;服务端脚本保存文件时需要先解码 base64。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
model | string | gpt-image-2 | 模型名称。 |
prompt | string | 必填 | 生图或编辑提示词。 |
n | integer | 1 | 单次生成数量。1k 档固定为 1,2k / 4k 档最多 4。 |
size | string | 1024x1024 | 比例如 1:1、16:9,或具体像素 WxH(例如 3840x2160)。 |
resolution | string | 空 | 清晰度档位:1k / 2k / 4k。 |
output_format | string | 空 | 输出格式:png / jpeg / webp。 |
output_compression | integer | 空 | 输出压缩质量,配合 jpeg 或 webp 使用。 |
background | string | 空 | 背景偏好:auto / transparent / opaque。 |
moderation | string | 空 | 内容审核强度:auto / low。 |
user | string | 空 | 调用方用户标识,便于审计。 |
wait_for_result | boolean | true | 传 false 进入异步提交。 |
image_urls | string | array | object | 空 | JSON 参考图字段,最多 9 张。 |
mask_url | string | 空 | 局部重绘遮罩,需配合至少 1 张参考图。 |
response_format | string | 空 | 传 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 | 典型耗时 | 说明 |
|---|---|---|---|
1k | 1 | 约 60 秒 | 起步档,适合预览或低成本批量。 |
2k | 4 | 约 120 秒 | 推荐档,适合大多数业务出图。 |
4k | 4 | 约 180 秒 | 高保真档,部分极端比例(如 21:9)也可用。 |
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
查询参数
Set to true to submit an async image task.
Set to false to submit an async image task.
请求体
application/json
1k resolution allows n=1 only; 2k and 4k allow up to 4.
必填范围:
1 <= x <= 4示例:
"1:1"
"16:9"
"3840x2160"
可用选项:
1k, 2k, 4k 示例:
"png"
"jpeg"
"webp"
示例:
"auto"
"transparent"
"opaque"
示例:
"auto"
"low"
示例:
"b64_json"