跳转到主要内容
POST
文档 Playground 不支持文件上传:请使用下方的 cURL、Python 或 JavaScript 代码示例进行测试。
重要变更: 为了更好的性能和成本控制,我们不再支持在生成接口中直接传入 base64 图片数据。请使用本接口上传图片,获取 URL 后再调用生成接口。

为什么需要先上传图片?

  1. 性能优化 - base64 编码会使数据膨胀 33%,先上传可显著减少请求体大小
  2. 复用图片 - 上传一次,URL 可多次使用,无需重复传输

使用流程

Authorizations

Authorization
string
必填
所有接口均需要使用Bearer Token进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

Body

file
file
必填
图片文件支持格式:JPEG (.jpg, .jpeg)、PNG (.png)、WebP (.webp)、GIF (.gif)最大文件大小:20MB

Response

url
string
图片的公开访问 URL,可直接用于生成接口(72 小时有效)
filename
string
原始文件名
content_type
string
检测到的 MIME 类型,如 image/jpeg
bytes
integer
文件大小(字节)
created_at
integer
上传时间的 Unix 时间戳(秒)

完整示例:图生图工作流

Python