增强视频提示词

把创作需求和可选多模态参考素材扩展成可直接使用的视频提示词。

Agent 主路径

当用户希望先完善视频提示词、再决定是否生成视频时，使用 beatra.videos.enhance_prompt。该任务只返回文本，绝不会自动继续生成视频。

上传本地图片、视频或音频参考素材。
提供创作 prompt、目标 duration 和 aspect_ratio。
可选提供严格首尾帧或一组有序参考素材，但同一请求不能同时使用两种模式。
用一个 client_request_id 只提交一次；通过 beatra.tasks.get 轮询。
审阅或修改返回的提示词，再单独发起视频生成。

AI 指南

给 AI 的集成说明

接入自有应用时，可以把这份 API 指南复制给 Claude、Codex 或其他编程助手。

Markdown

工具参数

{
  "prompt": "一只纸船在雨夜穿过霓虹街道",
  "duration": 5,
  "aspect_ratio": "16:9",
  "client_request_id": "vid-prompt-opaque-1"
}

第一期中，model 只是兼容输入。无论缺失、填 auto、其他值或其他类型，系统都会忽略，且不会改变请求身份；Beatra 会在内部解析可用的提示词增强模型。

目标时长为 4～15 秒整数。支持 21:9、16:9、4:3、1:1、3:4 和 9:16；只有媒体素材能够提供源比例时才能使用 adaptive。严格帧模式可提供可选首帧和可选尾帧。参考模式最多接收 5 张图片、3 个视频、3 段音频，合计不超过 11 项。每个参考视频或音频须为 2～15 秒，同类素材总时长各不超过 15 秒。

计费与任务状态

这是异步后付费任务。成功任务按实际上游 input/output token 结算：输入每百万 token 4,500 credits，输出每百万 token 18,000 credits；失败或取消不扣费。因此任务可在最终费用未知时先受理，终态任务会记录实际结算金额。

任务为 queued 或 running 时持续轮询同一个任务。只有完全相同的重试才能复用 client_request_id；prompt、目标规格或参考素材变化后必须使用新 ID。

REST API

直接协议集成可调用 POST /v1/videos/prompts/enhance。参数详见生成的 API operation。 Agent 推荐使用 Skill + MCP；REST 供自定义应用使用。