文件与输出 - ffmpeg-api-cloud

API 支持两种输入方式：

先通过 /v1/files 上传文件，再在任务中引用返回的资产 ID。
在任务请求里直接传入一个公网 URL。

上传流程

使用 POST /v1/files 创建上传槽位。
将媒体字节上传到返回的 uploadUrl。
在 POST /v1/jobs 中引用返回的文件 ID。

URL 流程

如果源文件本身已经能通过 HTTP 访问，可以直接在 input 数组中传入 URL。

输出

对于 FFmpeg 任务，你需要在 outputs 中声明命名输出，并在 ffmpegArgs 中引用它们。

{
  "outputs": {
    "thumbnail": {
      "fileName": "frame.jpg",
      "contentType": "image/jpeg"
    }
  },
  "ffmpegArgs": [
    "-i",
    "input0",
    "-frames:v",
    "1",
    "{{thumbnail}}"
  ]
}

FFprobe 任务会返回 JSON 输出，不需要声明文件输出。