DragonAPI

切换主题

GPT-Image-2 官方渠道 图像编辑 ​

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

基于参考图进行图像编辑 / 图生图 / 局部重绘（mask inpainting），使用 gpt-image-2 模型

  • 与图像生成使用同一端点 /v1/videos
  • 请求中包含 image_urls 即自动切换为编辑模式
  • 支持多参考图融合（最多 16 张）、局部重绘（mask）
  • 参考图须为公网可访问的 PNG / JPG，单张 ≤ 50MB

编辑模式的调用方式与生成完全兼容：只需在生成请求基础上加入 image_urls（和可选的 mask_url）即可，无需切换端点。

Authorizations ​

Authorization ​

string · 必填

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

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

text
Authorization: Bearer YOUR_DRAGONAPI_KEY

Body ​

model ​

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

固定填写 gpt-image-2

prompt ​

string · 必填

描述期望的编辑效果

示例："把背景换成星空，保持主体人物不变"

image_urls ​

string[] · 必填

参考图 URL 数组（触发编辑模式的关键字段）

  • 最多 16 张
  • 必须是公网可访问的稳定 URL（PNG / JPG，单张 ≤ 50MB）
  • 可使用 公开可访问的 HTTPS 图片地址 获取 URL

mask_url ​

string · 可选

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

  • 须为 PNG 格式，且包含 Alpha 通道
  • 透明区域（alpha = 0）为待重绘区域，不透明区域保持原样
  • 尺寸须与第一张参考图一致

size ​

string · 可选 · 默认 1:1

输出图像宽高比

支持 13 种比例，也可传 auto：

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

resolution ​

string · 可选 · 默认 1k

分辨率档位：1k / 2k / 4k

1K / 2K 支持全部 13 个比例；4K 仅支持 6 个比例（16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21）

quality ​

string · 可选 · 默认 high

图片质量：low / medium / high

n ​

integer · 可选 · 默认 1

生成数量，范围 1 ~ 10

output_format ​

string · 可选 · 默认 png

输出格式：png / jpeg

output_compression ​

integer · 可选 · 默认 100

JPEG 压缩强度，范围 0–100（仅对 output_format: "jpeg" 有效）

Response ​

id ​

string · 可选

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

object ​

string · 可选

固定为 generation.task

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",
    "prompt": "将两张参考图融合成赛博朋克风格插画海报",
    "image_urls": [
      "https://your-media.example/input-a.png",
      "https://your-media.example/input-b.png"
    ],
    "size": "1:1",
    "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",
    "prompt": "把背景换成沙漠日落，保持人物不变",
    "image_urls": ["https://your-media.example/photo.png"],
    "mask_url": "https://your-media.example/mask.png",
    "size": "1:1",
    "quality": "medium"
  }'
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",
    "prompt": "将照片转换为水彩画风格，保留场景构图",
    "image_urls": ["https://your-media.example/landscape.jpg"],
    "size": "16:9",
    "resolution": "2k",
    "quality": "high",
    "output_format": "jpeg",
    "output_compression": 85
  }'
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',
    prompt: '将两张参考图融合成赛博朋克风格插画海报',
    image_urls: [
      'https://your-media.example/input-a.png',
      'https://your-media.example/input-b.png',
    ],
    size: '1:1',
    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",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

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

DragonAPI