文档中心

统一 RESTful 规范 · 全部接口共用一套密钥与账单

获取文件上传签名

● 服务正常 按量计费 GET 通用接口

获取 S3 文件上传签名，把本地文件直传云存储后，把返回的 fileUrl 传给消除/修复等接口使用。文件 6 小时后自动删除。

调用权限
正常
请求频率
100 次/秒
免费额度
100
参考价格
0.0015 元/次原价 0.001 元/次
立即充值 获取密钥
GEThttps://api.vidtidy.cn/api/v1/upload-sign

鉴权：请求头 X-API-KEY: sk_live_…（也支持 key 查询参数）。

请求参数

名称必填类型说明
fileName必填 string原始文件名，如 111.mp4
contentType选填 string文件 MIME 类型，默认 video/mp4
expiresIn选填 number签名过期时间（秒），默认 900

返回参数

名称类型说明
uploadUrlstring文件上传地址
methodstring上传请求方法
formFieldsobject上传请求 multipart/form-data 参数（含签名字段）
objectKeystring文件 key
fileUrlstring上传完成后的文件完整地址，直接传给业务接口
bucketNamestring存储桶名称
expiresInnumber签名有效期（秒）
coststring本次扣费金额（元，4 位小数）
balancestring扣费后账户余额（元）

返回示例

{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "uploadUrl": "https://s3.example.com/",
    "fileUrl": "https://s3.example.com/obj/demo.mp4",
    "expiresIn": 900
  },
  "cost": "0.0015",
  "balance": "48.9985"
}
说明：先用本接口拿到签名，再用 POST multipart/form-data 把文件直传 S3；文件 6 小时后自动删除，请尽快使用。

计费口径

项目说明
计费方式按次计费，每成功调用一次扣一次
我方单价0.0015 元/次
定价口径所有价格已含接入、重试、对账与技术支持，无任何隐藏费用
预扣与退款按秒/按字类接口在提交时预扣，业务失败时 全额自动退回，无需申请
免费接口任务查询类接口永远免费，高频轮询不会产生费用
最低余额余额不足以支付本次预扣时会直接返回 402，不会产生任何调用

错误码

code含义处理建议
200成功—
-1业务异常见 msg。链接不支持 / 文件不可下载 / 时长超限最常见
401密钥无效检查请求头，或到控制台确认密钥未停用
402余额不足充值后重试，本次不扣费
429频率超限按 100 次/秒 退避
500服务异常平台波动，已自动退款
cURL 
curl -G "https://api.vidtidy.cn/api/v1/upload-sign" \
  -H "X-API-KEY: sk_live_你的密钥" \
  -d "fileName=示例值"
Python 
import requests

r = requests.get(
    "https://api.vidtidy.cn/api/v1/upload-sign",
    headers={"X-API-KEY": "sk_live_你的密钥"},
    params={"fileName": "示例值"},
    timeout=30,
)
print(r.json())
Node.js 
const url = new URL("https://api.vidtidy.cn/api/v1/upload-sign");
url.searchParams.set("fileName", "示例值");

const res = await fetch(url, {
  headers: { "X-API-KEY": "sk_live_你的密钥" },
});
console.log(await res.json());
PHP 
 true,
  CURLOPT_HTTPHEADER => ["X-API-KEY: sk_live_你的密钥"],
]);
$out = curl_exec($ch);
curl_close($ch);
echo $out;