从一句提示词到可用视频：用 Ace Data Cloud 接入 Flux Videos API

想在产品展示、短视频素材或创意原型中加入 AI 视频能力，却不想把应用逻辑绑在漫长的同步请求上？Ace Data Cloud 的 Flux Videos API 提供一个清晰的任务式流程：提交生成任务 → 获取任务 ID → 查询最终视频。同一入口覆盖文生视频、图片关键帧生视频、视频续写和草稿增强，适合开发者按场景逐步扩展。

本文根据 Ace Data Cloud 的 Flux Videos 接入指南整理。该接口目前处于 Beta；功能、参数和价格请以最新文档及服务页为准。

接入前准备

在 Ace Data Cloud 控制台创建应用并获取 API Token，确认应用可调用 Flux 服务且余额可用。服务方案与计费规则可查看 Flux 服务页。Token 只放在服务端环境变量中，不要写入网页、公开仓库或截图。

复制代码

export ACEDATACLOUD_API_TOKEN='替换为自己的 API Token'

接口基地址是 https://api.acedata.cloud；请求以 Authorization: Bearer $ACEDATACLOUD_API_TOKEN 鉴权，JSON 请求设置 Content-Type: application/json。

先跑通文生视频

下面用 flux-3 生成一段 5 秒的玩具帆船视频。action 省略时默认是 generate，mode=t2v 表示文生视频；设置 async=true 可以先拿到任务 ID，而不必保持长时间 HTTP 连接。

复制代码

curl -X POST 'https://api.acedata.cloud/flux/videos' \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "flux-3",
    "mode": "t2v",
    "prompt": "A small toy sailboat floating on calm blue water in warm morning light, steady camera, no text.",
    "duration": 5,
    "resolution": "hd",
    "draft": true,
    "async": true
  }'

受理响应会给出 task_id 和 trace_id。HTTP 200 或收到任务 ID 不等于视频已生成成功：把本次请求返回的 ID 保存下来，再查询任务；不要拿文档里的示例 ID 查询自己的任务。

复制代码

curl -X POST 'https://api.acedata.cloud/flux/tasks' \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"action":"retrieve","id":"替换为本次返回的 task_id"}'

任务完成后，从查询结果的 response 中检查 success，再读取 data[].video_url。data[].seconds/width/height/fps 是实际成片信息；usage 和 cost.amount 反映本次用量及以 Credit 为单位的费用。请求的 duration 不应被当成最终时长或账单数字。排障时保留 trace_id。

一套入口，扩展更多视频工作流

| 目标 | mode | 关键输入 | | --- | --- | --- | | 文生视频 | t2v | prompt | | 关键帧图生视频 | i2v | prompt、keyframes | | 视频续写 | v2v | prompt、start_video | | 草稿增强 | draft_enhance | 已完成草稿的 draft_task_id |

做商品展示时，可以用可访问的图片文件 URL 作为 keyframes 输入；需要衔接已有镜头时，使用 start_video 指向可读取的视频文件，而不是普通网页地址。使用临时签名 URL 时，要为下载和处理留足有效期。

想先看构图和运动，再处理成片，可先以 draft=true、resolution=hd 生成草稿，完成后取 data[0].draft_task_id，再以 mode=draft_enhance 提交增强任务。增强不能重新覆盖原始提示词等输入；草稿缓存并非永久存储，而且草稿与增强是两个分别计费的任务。

在实际业务中，建议把 task_id 与业务订单或素材记录关联，轮询时复用原 ID；如果使用 callback_url 接收最终 JSON，也要做好幂等处理。这样既能把异步生成接到自己的产品流程里，也便于追踪结果与成本。

去哪里看完整参数？

本文是快速上手版。duration、分辨率、画幅、音频、关键帧格式等约束，请查阅 Flux Videos API 完整文档和 Flux Tasks API。从控制台拿到 Token 后，先跑通一个短草稿，再把同一任务流程接进自己的应用，是更稳妥的第一步。