从一句提示词到可用视频用 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省略时默认是generatemodet2v表示文生视频设置asynctrue可以先拿到任务 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 时要为下载和处理留足有效期。想先看构图和运动再处理成片可先以drafttrue、resolutionhd生成草稿完成后取data[0].draft_task_id再以modedraft_enhance提交增强任务。增强不能重新覆盖原始提示词等输入草稿缓存并非永久存储而且草稿与增强是两个分别计费的任务。在实际业务中建议把task_id与业务订单或素材记录关联轮询时复用原 ID如果使用callback_url接收最终 JSON也要做好幂等处理。这样既能把异步生成接到自己的产品流程里也便于追踪结果与成本。去哪里看完整参数本文是快速上手版。duration、分辨率、画幅、音频、关键帧格式等约束请查阅 Flux Videos API 完整文档 和 Flux Tasks API。从控制台拿到 Token 后先跑通一个短草稿再把同一任务流程接进自己的应用是更稳妥的第一步。