上传文件

上传本地文件并获取一个托管 URL。在视频任务的 metadata.content[] 中使用该 URL，例如作为 reference_image。

#请求

以 multipart/form-data 形式发送：

字段	类型	说明
`file`	File	要上传的文件

#示例：cURL

terminalbash

curl https://relaydance.com/v1/files \
  -H "Authorization: Bearer $RELAYDANCE_API_KEY" \
  -F "file=@input.jpg"

#示例：Python

upload.pypython

import requests, os

with open("input.jpg", "rb") as f:
    resp = requests.post(
        "https://relaydance.com/v1/files",
        headers={"Authorization": f"Bearer {os.environ['RELAYDANCE_API_KEY']}"},
        files={"file": f},
    )

data = resp.json()
print(data["id"], data["url"])

#响应

response.jsonjson

{
  "id": "file_abc123",
  "url": "https://..."
}

字段	类型	说明
`id`	string	文件标识符
`url`	string	托管 URL，可直接用作参考媒体

端到端的完整流程见上传文件，该 URL 接入的 content[] 结构见生成视频。

←生成图像常见问题→