> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Kling-V3 モーションコントロール > - Kling-V3 Motion Control (kling-v3-motion-control) モデルは、**参照画像 + 参照動画**によるモーション駆動生成をサポートしています - システムは参照動画からモーション軌跡を抽出し、参照画像内のキャラクター/オブジェクトに適用して、参照動画の動きと一致する新しい動画を生成します - 生成される動画の長さは `character_orientation` に依存します。`image` は最大 10 秒、`video` は最大 30 秒、最短 3 秒です - 非同期処理モード、返されたタスクIDで[クエリを実行](/ja/api-manual/task-management/get-task-detail)してください - 生成された動画リンクの有効期限は24時間です。お早めに保存してください ## OpenAPI ````yaml ja/api-manual/video-series/kling/kling-v3-motion-control.json POST /v1/videos/generations openapi: 3.1.0 info: title: kling-v3-motion-control API description: AIモデルを使用したモーションコントロール動画タスクの作成 license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: 本番環境 security: - bearerAuth: [] tags: - name: 動画生成 description: AI動画生成関連インターフェース paths: /v1/videos/generations: post: tags: - 動画生成 summary: kling-v3-motion-control API description: >- - Kling-V3 Motion Control (kling-v3-motion-control) モデルは、**参照画像 + 参照動画**によるモーション駆動生成をサポートしています - システムは参照動画からモーション軌跡を抽出し、参照画像内のキャラクター/オブジェクトに適用して、参照動画の動きと一致する新しい動画を生成します - 生成される動画の長さは `character_orientation` に依存します。`image` は最大 10 秒、`video` は最大 30 秒、最短 3 秒です - 非同期処理モード、返されたタスクIDで[クエリを実行](/ja/api-manual/task-management/get-task-detail)してください - 生成された動画リンクの有効期限は24時間です。お早めに保存してください operationId: createVideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: basic: summary: 基本モーションコントロール value: model: kling-v3-motion-control prompt: A girl dancing gracefully image_urls: - https://example.com/character.jpg video_urls: - https://example.com/dance-reference.mp4 quality: 720p model_params: character_orientation: image hd_no_sound: summary: 高画質 + 元音声なし value: model: kling-v3-motion-control prompt: A robot performing martial arts image_urls: - https://example.com/robot.png video_urls: - https://example.com/martial-arts.mp4 quality: 1080p model_params: character_orientation: video keep_sound: false with_element: summary: 主体要素コントロール付き value: model: kling-v3-motion-control image_urls: - https://example.com/person.jpg video_urls: - https://example.com/walking.mp4 model_params: character_orientation: video element_list: - element_id: '123456789' responses: '200': description: 動画生成タスクの作成に成功しました content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: リクエストパラメータエラー content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: 未認証、トークンが無効または期限切れ content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: クォータ不足、チャージが必要 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: アクセス権限がありません content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: kling-v3-motion-control' type: invalid_request_error '429': description: リクエスト頻度が上限を超えました content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: サーバー内部エラー content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: VideoGenerationRequest: type: object required: - model - image_urls - video_urls - model_params properties: model: type: string description: 動画生成モデル名 enum: - kling-v3-motion-control default: kling-v3-motion-control example: kling-v3-motion-control image_urls: type: array items: type: string format: uri description: |- 参照画像URL配列、キャラクター/オブジェクトの外観ソースを提供するために使用 **注意：** - 参照画像を1枚入力してください - 画像サイズ：`10MB`以下 - 対応ファイル形式：`.jpg`、`.jpeg`、`.png` - 画像サイズ：幅・高さ ≥ `300px`、アスペクト比は `1:2.5` ～ `2.5:1` の範囲 - 画像URLはサーバーから直接アクセス可能である必要があります example: - https://example.com/character.jpg video_urls: type: array items: type: string format: uri description: |- 動作トラジェクトリを提供するための参照動画URL配列 **注意：** - 参照動画を1つ渡してください - 動画の長さ：`3`〜`30`秒 - 動画サイズ：最大 `100MB` - 動画寸法：幅と高さそれぞれ `340px` 〜 `3850px` - カット割り、高速な動き、シーン変更は避けてください - 動画URLはサーバーから直接アクセスできる必要があります example: - https://example.com/dance-reference.mp4 prompt: type: string description: |- テキストプロンプト（オプション）、生成内容のガイドに使用 **注意：** - 最大`2500`文字 - 空欄可、モデルが参照画像と動画に基づいて自動生成します example: A girl dancing gracefully maxLength: 2500 quality: type: string description: |- 解像度レベル **説明：** - `720p`：標準画質（std） - `1080p`：高品質画質（pro） enum: - 720p - 1080p default: 720p example: 720p model_params: type: object required: - character_orientation description: モデル固有パラメータ（必須）、モーションコントロール設定に使用 properties: character_orientation: type: string description: |- 生成される人物の向いている方向を制御します。 **値：** - `image`：参照画像と同じ向き（最大 10 秒） - `video`：参照動画と同じ向き（最大 30 秒） **注意：** - `element_list` 使用時は `video` のみサポート enum: - image - video example: image element_list: type: array description: |- 主体要素リスト、制御対象のキャラクター/オブジェクトを指定するために使用 **注意：** - 最大 `1` つの主体要素（Motion Control の制限） - `element_id`：主体要素ID - `video_refer` 参照タイプで作成された要素のみサポートされます（`image_refer` は非対応） items: type: object properties: element_id: type: string description: 主体要素ID required: - element_id maxItems: 1 keep_sound: type: boolean description: |- 参照動画の元音声を保持するかどうか **説明：** - `true`：元音声を保持（デフォルト） - `false`：ミュート default: true example: true watermark_info: type: object description: ウォーターマーク設定 properties: enabled: type: boolean description: ウォーターマークを有効にするかどうか callback_url: type: string description: |- タスク完了後のHTTPSコールバックアドレス **コールバックのタイミング：** - タスクが完了（completed）、失敗（failed）、またはキャンセル（cancelled）された際にトリガーされます - 課金確認が完了した後に送信されます **セキュリティ制限：** - HTTPSプロトコルのみサポート - 内部ネットワークIPアドレスへのコールバックは禁止 - URL長さは`2048`文字以内 **コールバックメカニズム：** - タイムアウト時間：`10`秒 - 失敗後の最大リトライ回数：`3`回 - コールバックレスポンスの形式はタスク照会インターフェースの返却形式と一致します - コールバックアドレスが2xxステータスコードを返した場合は成功、それ以外のステータスコードはリトライをトリガーします format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: タスク作成タイムスタンプ example: 1757169743 id: type: string description: タスクID example: task-unified-1757169743-7cvnl5zw model: type: string description: 実際に使用されたモデル名 example: kling-v3-motion-control object: type: string enum: - video.generation.task description: タスクの具体的なタイプ progress: type: integer description: タスク進捗パーセンテージ (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: タスクステータス enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: 動画タスク詳細情報 type: type: string enum: - text - image - audio - video description: タスクの出力タイプ example: video usage: $ref: '#/components/schemas/VideoUsage' description: 使用量と課金情報 ErrorResponse: type: object properties: error: type: object properties: code: type: string description: エラーコード識別子 message: type: string description: エラー説明情報 type: type: string description: エラータイプ VideoTaskInfo: type: object properties: can_cancel: type: boolean description: タスクがキャンセル可能かどうか example: true estimated_time: type: integer description: 推定完了時間（秒） minimum: 0 example: 300 video_duration: type: integer description: >- 動画の長さ（秒）。`character_orientation` に依存します。`image` は最大 10 秒、`video` は最大 30 秒です example: 8 VideoUsage: type: object description: 使用量と課金情報 properties: billing_rule: type: string description: 課金ルール enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: 推定消費クレジット数 minimum: 0 example: 408240 user_group: type: string description: ユーザーグループカテゴリ example: default securitySchemes: bearerAuth: type: http scheme: bearer description: |- ##すべてのインターフェースはBearer Token認証が必要です## **API Keyの取得：** [API Key管理ページ](https://evolink.ai/dashboard/keys)にアクセスしてAPI Keyを取得してください **リクエストヘッダーに以下を追加してください：** ``` Authorization: Bearer YOUR_API_KEY ``` ````