两步式上传签名（Presign）

POST

/api/uploads/presign

为参考图、参考视频、参考音频生成临时 PUT upload_url 和可访问的 public_url。该接口是 Next BFF，但支持 Authorization: Bearer <proxy key>，适合外部集成保留原始两步上传链路。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

参考图上传签名

{
  "media_kind": "reference_image",
  "file_name": "hero-frame.png",
  "content_type": "image/png",
  "file_size": 1431473
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

示例 1示例 2

curl --location 'https://api.seedance.show/api/uploads/presign' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "media_kind": "reference_image",
  "file_name": "hero-frame.png",
  "content_type": "image/png",
  "file_size": 1431473
}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
  "data": {
    "object_key": "temp/user-1/reference_image/1775822355409/abcd1234-pic-1.png",
    "upload_url": "https://uploads.seedance.show/seed2-uploads/temp/user-1/reference_image/1775822355409/abcd1234-pic-1.png?X-Amz-Signature=...",
    "public_url": "https://uploads.seedance.show/seed2-uploads/temp/user-1/reference_image/1775822355409/abcd1234-pic-1.png",
    "expires_at_ms": 1775822355409,
    "headers": {
      "content-type": "image/png"
    }
  }
}

🟠400

🟠401

🔴502

修改于 2026-06-03 05:53:31

查询任务

一步式图床上传（仅上传并返回 URL）