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

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

## Agent 主路径

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

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

## AI 指南

AI integration guide: https://docs.beatra.ai/llms/videos-video-prompt-enhancement.md

## 工具参数

```json
{
  "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 积分，输出每百万 token 18,000 积分；失败或取消不扣费。因此任务可在最终费用
未知时先受理，终态任务会记录实际结算金额。

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

## REST API

直接协议集成可调用 `POST /v1/videos/prompts/enhance`。参数详见生成的
[API operation](https://docs.beatra.ai/zh/docs/api-reference/operations/videos/videos_enhance_prompt_v1_videos_prompts_enhance_post)。
Agent 推荐使用 Skill + MCP；REST 供自定义应用使用。