1. 图片(Images)
大洋芋API
  • 接口(新)
    • 图片(Images)
      • 香蕉(异步)
        POST
      • gpt-image-2(异步)
        POST
      • image2(流式)
        POST
      • 任务查询
        GET
    • 视频(Videos)
      • sora创建
      • veo创建
      • 任务查询
  • 接口(作废)
    • sora2视频生成(作废)
      • sora2 去水印(作品地址)
      • sora2 去水印(草稿未发作品)
      • sora2 Chat(聊天格式兼容)
      • Sora2 文生视频(异步请求)
      • Sora2 图生视频直接传图(异步请求)
      • Sora2 图生视频URL传图(异步请求)
      • Sora2 任务进度(异步查询)
      • Sora2 查看视频内容
    • sora2 角色 Remix 故事板(作废)
      • sora2 文生视频
      • sora2 图生视频 URL
      • Sora2 图生视频
      • sora2 Remix 二创文生视频
      • Sora2 Remix 二创图生视频
      • Sora2 Remix 二创图生视频 删除首帧
      • sora2 故事板文生视频
      • Sora2 故事板图生视频
      • sora2 角色创建
      • sora2 角色创建 URL指定视频
      • sora2 指定任务剪辑
      • Sora2 任务进度/角色任务/查询
      • Sora2 预览任务视频
  1. 图片(Images)

image2(流式)

开发中
POST
https://api.dyuapi.com/v1/images/generations

gpt-image-2 接口文档(/v1/images/generations OpenAI 原生格式)#

接口地址#

文生图:POST /v1/images/generations
图生图(图片编辑):POST /v1/images/edits

功能说明#

采用 OpenAI 兼容格式的图片生成接口,支持文生图和图生图两种模式,支持同步返回和异步任务两种调用方式。

支持的模型#

model 参数说明
image2GPT 图片生成模型

请求头#

参数名类型必填说明
Authorizationstring是Bearer YOUR_API_KEY
Content-Typestring是文生图 / 图生图均支持 application/json 与 multipart/form-data

一、文生图接口#

接口地址#

POST /v1/images/generations

请求参数#

参数名类型必填说明
modelstring是模型名称,固定为 image2
promptstring是图片描述,用于生成图片
sizestring否图片尺寸,格式自己定义
imagestring 或 string[]否带参考图:单张传字符串,多张传数组。不传则为纯文生图

请求示例(JSON 格式 — 纯文生图)#

请求示例(JSON 格式 — 带参考图 URL,单图或多图)#

请求示例(表单格式)#


二、图生图(图片编辑)接口#

接口地址#

POST /v1/images/edits

请求参数#

参数名类型必填说明
modelstring是模型名称,固定为 image2
promptstring是图片描述,用于编辑图片
image见说明是JSON:string(单图)或 string[](多图),Multipart:一个或多个 文件 字段(字段名依上游约定,常见为 image / image[])
sizestring否图片尺寸,格式同文生图

请求示例(JSON — URL 或多图 URL)#

请求示例(JSON — Data URL / Base64)#

{
  "model": "image2",
  "prompt": "变成灰色",
  "size": "1024x1792",
  "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
}
多图时 "image": ["data:image/png;base64,...", "https://..."] 与 generations 用法一致。

请求示例(表单格式 - 本地文件)#

请求示例(多图上传)#

Python 示例(JSON,直接传 URL)#

Python 示例(multipart 上传本地文件)#


三、响应示例#

同步响应 - Base64 格式(默认)#

{
  "created": 1234567890,
  "data": [
    {
      "b64_json": "data:image/png;base64,iVBORw0KGgoAAAANSU..."
    }
  ]
}

任务状态说明#

status说明
queued任务排队中
in_progress任务处理中
completed任务已完成
failed任务失败

注意事项#

1.
接口格式:采用 OpenAI 兼容的原生图片接口格式,与 OpenAI 官方 SDK 通用
2.
调用方式:接口直接返回生成结果,适合对实时性要求高的场景
3.
响应格式:
b64_json(默认):直接返回 Base64 编码的图片数据,前端可直接渲染
4.
尺寸支持:
竖屏:1024x1792
横屏:1792x1024
方形:1024x1024
其他尺寸:可在size参数自由设置
5.
参考图与格式:/v1/images/generations 与 /v1/images/edits 均可在 application/json 下用 image 传 URL 或 Base64 / Data URL(字符串或数组);需要走文件流时用 multipart/form-data。具体字段名、是否支持裸 Base64 以实际上游实现为准
6.
参考图片格式:支持 JPEG、PNG、WEBP 格式,最多10张图片
7.
图片有效期:返回的图片 URL 有效期为 2 小时,请及时下载保存
8.
模型区别:该接口使用模型名 image2,如需通过 /v1/videos 接口调用,请使用模型名 gpt-image-2

请求参数

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200成功
application/json
Bodyapplication/json

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.dyuapi.com/v1/images/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "model": "image2",
  "prompt": "根据图片做一个广告",
  "size": "1024x1792",
  "image": [
    "https://res.papir.cc/user-upload/creati-web-app/2026-04-18/1776519962551vv1AXmBu-ZMWqAckJIbt81167-600x751h.jpg",
    "https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png"
  ]
}'
响应示例响应示例
{}
上一页
gpt-image-2(异步)
下一页
任务查询
Built with