> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anyfast.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# kling-v3 - 动作控制

> 通过 kling-v3 旧版动作控制接口，将参考视频中的动作迁移到角色参考图。

Kling 3.0 动作控制可将参考视频中的肢体动作迁移到参考图片中的角色。调用旧版动作控制接口时使用 `model_name: "kling-3.0"`。

## 快速示例

```bash theme={null}
curl https://www.anyfast.ai/kling/v1/videos/motion-control \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-3.0",
    "image_url": "https://example.com/character.png",
    "video_url": "https://example.com/motion.mp4",
    "prompt": "角色在摄影棚中表演参考视频里的舞蹈",
    "character_orientation": "image",
    "keep_original_sound": "yes",
    "mode": "pro"
  }'
```

## 输入要求

* `image_url` 支持可访问 URL 或不带 data URI 前缀的原始 Base64。格式为 JPG、JPEG 或 PNG，不超过 10 MB；宽高范围 300–65,536 px，宽高比范围 1:2.5 至 2.5:1。
* 图片应清晰展示角色上半身或全身，包含头部和四肢，避免明显遮挡或倒立、平躺等极端方向。
* `video_url` 支持 MP4 或 MOV，不超过 100 MB，宽高范围 340–3,850 px。建议使用角色持续清晰可见、没有切镜且运镜较少的单镜头视频。
* 参考视频至少 3 秒。`character_orientation: "image"` 时最长 10 秒；设为 `"video"` 时最长 30 秒。
* `element_list` 最多引用一个主体。引用主体时，角色方向暂时只能跟随参考视频。

<Warning>
  如果动作难度较高或速度较快，生成结果可能短于上传视频，因为模型只会提取有效的连续动作片段进行生成；最短提取出 3 秒可用连续动作即可生成。此类情况下已消耗的积分无法退还，建议适当降低动作难度或速度。
</Warning>

<Card title="API 参考" icon="code" href="/zh/api-reference/model-api/kuaishou/kling-v3-motion-control">
  查看完整的旧版请求参数。
</Card>

<script src="/feedback.js" />