上传图片

POST

/openapi/v1/uploads/images

一步式上传图片接口。用户上传本地图片后，超然POD平台会校验图片并保存到当前账号资产，成功后返回 asset_id。后续创建图片类任务时，可在 input.assetId 中传入该 asset_id。

上传限制：

文件字段名固定为 file。

单张图片最大 10MB。

图片长边最大 4096px。

仅支持 JPG、PNG、WebP。

不支持 base64。

请求参数

Header 参数

Body 参数multipart/form-data

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v1/uploads/images' \
--header 'x-api-key: {{api_key}}' \
--form 'file=@""' \
--form 'filename=""'

返回响应

🟢200成功

application/json

图片上传成功

Bodyapplication/json

示例

{
    "code": "0",
    "message": "ok",
    "data": {
        "asset_id": "8b2e5c2f-1111-2222-3333-123456789abc",
        "filename": "demo.png",
        "content_type": "image/png",
        "width": 1200,
        "height": 800,
        "size_bytes": 245760
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠413

🟠429

修改于 2026-06-08 09:06:35

查询标题模板列表