提供输入文件
接收图像、视频或音频输入的模型,把它们当作 input 对象内的公开 HTTPS URL 读取 —— 没有单独的上传接口。
输入文件的工作方式
把文件托管在任何能以公开 HTTPS 提供的地方,然后在模型的 input 字段中引用该 URL(例如 image_url):
JSON
{
"model": "bytedance/seedance-2-image-to-video",
"input": {
"image_url": "https://your-cdn.example.com/photo.jpg",
"prompt": "cinematic slow push-in"
}
}使用已托管的 URL
文件已在线 —— 直接传 URL
从 Base64 数据
先解码存储,再传 URL
从本地文件
先上传到你自己的存储,再传 URL
URL 要求
- 公开可达 —— 前面没有登录、cookie 或 IP 白名单。
- HTTPS 且证书有效。
- 直接返回文件 —— URL 必须返回媒体字节(
Content-Type正确),而不是 HTML 预览页。 - 文件大小要合理;过大的源会拖慢任务或在上游失败。
提交任务前的快速自检:
cURL
curl -I "https://your-cdn.example.com/photo.jpg"
# expect: HTTP/2 200 + Content-Type: image/jpeg端到端示例
cURL
# 1) start the task, referencing your hosted file
curl -X POST "https://97ai.97claude.com/api/generate" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedance-2-image-to-video",
"input": {
"image_url": "https://your-cdn.example.com/photo.jpg",
"prompt": "cinematic slow push-in"
}
}'
# → { "taskId": "task_12345678", "state": "waiting" }
# 2) poll until success / fail
curl "https://97ai.97claude.com/api/generate/task_12345678" \
-H "Authorization: Bearer $API_KEY"文件托管在哪里
- 你自己的对象存储:AWS S3、阿里云 OSS、腾讯云 COS、Cloudflare R2(公开 bucket 或预签名 URL)
- 你应用现有的 CDN 或静态文件服务器
- 任何能返回直接文件 URL 的图片/文件托管服务
预签名 URL 可用
限时预签名 URL(S3/OSS/COS)没问题 —— 只要在任务运行的几分钟内保持有效即可。
常见问题
- 403 / 防盗链 —— 主机拦截非浏览器请求;关闭 referer 校验或改用预签名 URL。
- 返回 HTML 而非文件 —— 你传的是分享页链接(Google Drive、网盘)而不是直接文件 URL。
- Localhost / 内网 URL ——
http://localhost/…或私有 IP 平台无法访问。
支持
发邮件到 [email protected],或在各模型页查看该模型确切的 input 字段。