DragonAPI

切换主题

GPT-Image-2 官方渠道 图像生成 ​

使用 DragonAPI 密钥和本站接口。示例中的 your-media.example 是占位地址，需替换为你自己的可访问素材或回调地址。协议、可用性与价格以当前模型说明和控制台为准。

使用 OpenAI 官方 gpt-image-2-official 模型生成图像，支持文生图 / 图生图 / 局部重绘（mask）三合一，1K / 2K / 4K 分辨率档位

  • OpenAI 官方 gpt-image-2-official 模型
  • 异步处理模式，返回任务 ID 用于后续查询
  • 支持文生图、多参考图图生图、遮罩局部重绘（inpainting）
  • 支持 13 种宽高比，可选 1K / 2K / 4K 三档分辨率
  • 单次最多生成 4 张图，参考图最多 16 张

注意 ：gpt-image-2-official 不支持透明背景，传入 background: "transparent" 会被静默降级为 auto。

Authorizations ​

Authorization ​

string · 必填

所有接口均需要使用 Bearer Token 进行认证

获取 DragonAPI API Key：访问 DragonAPI 密钥管理页面 获取您的 API Key

使用时在请求头中添加：

text
Authorization: Bearer YOUR_DRAGONAPI_KEY

Body ​

model ​

string · 必填 · 默认 gpt-image-2-official

图像生成模型名称

固定填写 gpt-image-2-official

prompt ​

string · 必填

图像生成的文本描述

支持中英文，建议详细描述场景、风格和构图

size ​

string · 可选 · 默认 1:1

画面宽高比

支持以下比例，也可传 auto 由服务端根据 prompt 自动选择：

1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 5:4 · 4:5 · 16:9 · 9:16 · 2:1 · 1:2 · 21:9 · 9:21

4K 档仅支持 6 个比例：16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21，其余比例请使用 1K 或 2K。

resolution ​

string · 可选 · 默认 1k

分辨率档位

  • 1k — 1024 基准，速度快，日常够用（默认）
  • 2k — 2048 基准，适合海报 / 高清需求
  • 4k — 3840 基准，仅支持上述 6 个比例，high 质量下耗时可达 130s

尺寸对照表 ​

size1K2K4K
1:11024x10242048x2048不支持
3:21536x10242048x1360不支持
2:31024x15361360x2048不支持
4:31024x7682048x1536不支持
3:4768x10241536x2048不支持
5:41280x10242560x2048不支持
4:51024x12802048x2560不支持
16:91536x8642048x11523840x2160
9:16864x15361152x20482160x3840
2:12048x10242688x13443840x1920
1:21024x20481344x26881920x3840
21:92016x8642688x11523840x1648
9:21864x20161152x26881648x3840

quality ​

string · 可选 · 默认 high

图片质量

  • low — 快速省钱，适合草稿/预览
  • medium — 平衡速度与质量
  • high — 最高精度，默认值（4K + high 耗时可达 120s+）

output_format ​

string · 可选 · 默认 png

输出格式

  • png — 默认
  • jpeg — 文件更小（支持压缩）

output_compression ​

integer · 可选 · 默认 100

JPEG 压缩强度，范围 0–100（0 不压缩，100 最大压缩，默认 100）

仅对 output_format: "jpeg" 有效

n ​

integer · 可选 · 默认 1

生成图片张数

取值范围：1 ~ 10

image_urls ​

string[] · 可选

参考图 URL 数组，用于图生图

  • 最多 16 张 ，须为公网可访问的稳定 URL
  • 可先使用 公开可访问的 HTTPS 图片地址 获取 URL

mask_url ​

string · 可选

遮罩图 URL，用于局部重绘（inpainting）

需搭配 image_urls 使用，遮罩图尺寸须与首张参考图一致，且需包含 Alpha 通道（透明区域为待重绘区域）

Response ​

id ​

string · 可选

任务唯一标识符，用于查询任务状态

object ​

string · 可选

对象类型，固定为 generation.task

model ​

string · 可选

使用的模型名称

status ​

string · 可选

任务状态

  • queued — 排队等待处理
  • in_progress — 处理中
  • completed — 成功完成
  • failed — 失败

progress ​

integer · 可选

任务进度百分比（0-100）

created_at ​

integer · 可选

任务创建时间戳（Unix 时间戳）

curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2-official",
    "prompt": "星空下的古老城堡，电影感光影，超写实风格",
    "size": "16:9",
    "resolution": "2k",
    "quality": "high",
    "n": 1
  }'
curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2-official",
    "prompt": "雪山日出全景，极致细节",
    "size": "16:9",
    "resolution": "4k",
    "quality": "high",
    "output_format": "jpeg",
    "output_compression": 90
  }'
curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2-official",
    "prompt": "将两张参考图融合成一张插画海报，保留主体轮廓",
    "size": "1:1",
    "quality": "high",
    "image_urls": [
      "https://your-media.example/input-a.png",
      "https://your-media.example/input-b.png"
    ]
  }'
curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2-official",
    "prompt": "把背景换成沙漠日落",
    "size": "1:1",
    "quality": "medium",
    "image_urls": ["https://your-media.example/photo.png"],
    "mask_url": "https://your-media.example/mask.png"
  }'
const response = await fetch('https://newapi.dragon3api.com/v1/videos', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_DRAGONAPI_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-image-2-official',
    prompt: '星空下的古老城堡，电影感光影，超写实风格',
    size: '16:9',
    resolution: '2k',
    quality: 'high',
    n: 1
  })
});

const task = await response.json();
console.log(task.id, task.status);
{
  "id": "tsk_img_01KPTXXXXXXXXXXXXXXX",
  "object": "generation.task",
  "model": "gpt-image-2-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

模型、价格与服务规则以当前控制台为准。

DragonAPI