How does Kling per-second billing work on RunAPI?

Kling charges per second of generated video. The rate depends on output_resolution and whether enable_sound is on. A 5-second 720p clip without sound is the cheapest option; 1080p with sound costs roughly twice as much per second. Check the RunAPI pricing page for exact rates.

What happens when a Kling generation fails -- do I lose credits?

No. RunAPI only bills for completed generations. If the task fails or times out, the reserved credits are rolled back to your account balance.

Can Kling generate videos with sound?

Yes. Set enable_sound to true in the request body. Kling 3.0 generates synchronized audio matching the video content. Sound generation increases the per-second cost -- at 720p, sound adds about 3 cents per second.

How long does Kling generation actually take?

Generation typically takes 30 to 120 seconds depending on duration and resolution. Longer clips at 1080p with sound take the most time. The API returns a task_id immediately so your agent can do other work while waiting.

Can I control camera motion in Kling videos?

Kling 3.0 has a separate motion_control endpoint at /api/v1/kling/motion_control for applying motion presets to a source image with a reference video. The text_to_video endpoint relies on prompt descriptions for camera direction.

OPENCLAW + KLING

OpenClaw で Kling を使う。

Kuaishou の Kling 3.0 は、テキストまたは画像から最大 1080p の動画を生成し、ネイティブ音声、マルチショットシーン、3〜15秒の尺に対応します。OpenClaw のエージェントはチャットと同じ APIキーを使って RunAPI 経由で呼び出します——プロンプトを送信し、タスクをポーリングして、動画 URL を受け取ります。

API キーを取得ドキュメントを読む

1つの APIキー · テキスト→動画 + 画像→動画 · 秒単位の課金

RunAPI を使って Kling 3.0 で動画を生成します。

要件：
- POST https://runapi.ai/api/v1/kling/text_to_video を呼び出す
- model を "kling-3.0" に設定する
- RUNAPI_API_KEY 環境変数から APIキーを読み込む
- duration_seconds で尺を制御する（3〜15秒）
- 横向き動画には aspect_ratio を "16:9" に設定する
- ネイティブ音声には enable_sound: true で音声を有効化する
- レスポンスは非同期です——タスクが完了するまでタスクステータスエンドポイントをポーリングし、動画 URL を取得します

curl -X POST https://runapi.ai/api/v1/kling/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0",
    "prompt": "A drone shot pulling back from a mountain lake at sunrise, mist rising off the water, cinematic lighting",
    "duration_seconds": 5,
    "aspect_ratio": "16:9",
    "enable_sound": true,
    "output_resolution": "1080p"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "kling-3.0"
}

curlコマンドをコピーしてテスト kling

仕組み

OpenClaw で Kling を使う3ステップ

Configure RunAPI

Set the RUNAPI_API_KEY environment variable. If you already configured RunAPI as an OpenClaw provider for chat, the same key works for video generation — no extra setup needed.

export RUNAPI_API_KEY=runapi_xxx

Call Kling text_to_video

Send a POST to /api/v1/kling/text_to_video with model set to kling-3.0. Include a prompt, duration_seconds (3–15), aspect_ratio, and optionally enable_sound for native audio. For image-driven generation, use /api/v1/kling/image_to_video with a first_frame_image_url instead.

POST /api/v1/kling/text_to_video

Poll for the result

The endpoint returns a task_id immediately. Poll the task status endpoint until the status changes to completed, then retrieve the video URL from the response. Generation typically takes 30–120 seconds depending on duration and resolution.

GET /api/v1/kling/text_to_video/tsk_abc123

パラメータ

Kling text_to_video API パラメータ

パラメータ	型	説明
`model`	`string`	Required. kling-3.0 for the latest version.
`prompt`	`string`	Video description. Required unless multi_shots is enabled.
`duration_seconds`	`integer`	Video length. Kling 3.0 supports 3–15 seconds. Older versions accept 5 or 10.
`aspect_ratio`	`string`	Output aspect ratio: 16:9, 9:16, or 1:1.
`output_resolution`	`string`	Resolution: 720p, 1080p, or 4k. Higher resolution costs more per second.
`enable_sound`	`boolean`	Generate native audio alongside video. Increases per-second cost.
`negative_prompt`	`string`	Elements to exclude from generation.
`first_frame_image_url`	`string`	Image URL to use as the opening frame (single-shot mode).
`cfg_scale`	`number`	Guidance scale (0–1). Higher values follow the prompt more closely.
`multi_shots`	`boolean`	Enable multi-shot scene generation with separate prompts per segment.

OpenClaw上のKlingとは？

KuaishouのKling 3.0は優れた布シミュレーション・流体力学・モーション物理による映画品質の動画で知られています。テキストまたは画像から最長3分・最大1080pの動画をネイティブ音声・マルチショットシーン付きで生成します。OpenClaw agentはRunAPIエンドポイント経由でチャットと同じAPIキーを使って呼び出します。