RunComfy の API で kling/kling-3.0/4k/text-to-video を実行します。 受け付ける入出力はモデルの スキーマ。
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/4k/text-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Native-4K cinematic multi-shot of a Brooklyn artisan coffee shop on a rainy autumn morning. Wide establishing shot through a fogged-up window: a bearded American barista in a denim apron stands behind a polished copper espresso machine, brass fixtures glowing under warm Edison bulbs, exposed brick and hanging plants in the background. Cut to an extreme macro close-up of milk being steamed, micro-foam swirling with visible bubbles and droplets. Cut to a top-down macro shot of his hands pouring a perfect rosetta latte art into a matte ceramic cup, golden crema rippling in slow motion. Cut to a young woman in a cream cable-knit sweater receiving the cup, soft window light catching freckles on her cheeks, green eyes warming as she smiles. Final shot: a slow dolly-out reveals the cozy industrial interior — vinyl records spinning, a chalkboard menu, raindrops streaking the window. Sound of espresso machine hissing, gentle rain on glass, soft indie acoustic guitar. Hyper-detailed textures: yarn weave, hair strands, crema bubbles, raindrop refraction — shot on RED Komodo 6K, anamorphic lenses, shallow depth of field, Kodak Portra color science."
}'環境変数 YOUR_API_TOKEN に API キーを設定してください（ プロフィールでキー管理）。すべてのリクエストの Authorization ヘッダーに Bearer トークンとして付与： Authorization: Bearer $YOUR_API_TOKEN。
非同期の生成ジョブを送信すると、すぐに request_id と、ステータス確認・結果取得・キャンセル用の URL が返ります。
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/4k/text-to-video \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "Native-4K cinematic multi-shot of a Brooklyn artisan coffee shop on a rainy autumn morning. Wide establishing shot through a fogged-up window: a bearded American barista in a denim apron stands behind a polished copper espresso machine, brass fixtures glowing under warm Edison bulbs, exposed brick and hanging plants in the background. Cut to an extreme macro close-up of milk being steamed, micro-foam swirling with visible bubbles and droplets. Cut to a top-down macro shot of his hands pouring a perfect rosetta latte art into a matte ceramic cup, golden crema rippling in slow motion. Cut to a young woman in a cream cable-knit sweater receiving the cup, soft window light catching freckles on her cheeks, green eyes warming as she smiles. Final shot: a slow dolly-out reveals the cozy industrial interior — vinyl records spinning, a chalkboard menu, raindrops streaking the window. Sound of espresso machine hissing, gentle rain on glass, soft indie acoustic guitar. Hyper-detailed textures: yarn weave, hair strands, crema bubbles, raindrop refraction — shot on RED Komodo 6K, anamorphic lenses, shallow depth of field, Kodak Portra color science."
}'request_id の現在の状態を取得します（"in_queue"、"in_progress"、"completed"、"cancelled"）。
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"指定した request_id の最終出力とメタデータを取得します。ジョブが未完了の場合は現在の状態が返るため、ポーリングを続けられます。
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"request_id でキュー中のジョブをキャンセルします。実行中のジョブはキャンセルできません。
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"公開到達可能な HTTPS URL を指定してください。サーバー側からの取得が可能で、ログイン不要であること、レート制限やボット遮断がないことを確認してください。目安：画像 ≤ 50 MB（約 4K）、動画 ≤ 100 MB（720p で約 2～5 分）。非公開アセットは安定した URL またはプリサイン URL を推奨します。
{
"type": "object",
"title": "入力スキーマ",
"required": [
"prompt"
],
"properties": {
"prompt": {
"title": "プロンプト",
"description": "シーン、動き、カメラスタイル、雰囲気をテキストで説明します。",
"type": "string",
"default": "Native-4K cinematic multi-shot of a Brooklyn artisan coffee shop on a rainy autumn morning. Wide establishing shot through a fogged-up window: a bearded American barista in a denim apron stands behind a polished copper espresso machine, brass fixtures glowing under warm Edison bulbs, exposed brick and hanging plants in the background. Cut to an extreme macro close-up of milk being steamed, micro-foam swirling with visible bubbles and droplets. Cut to a top-down macro shot of his hands pouring a perfect rosetta latte art into a matte ceramic cup, golden crema rippling in slow motion. Cut to a young woman in a cream cable-knit sweater receiving the cup, soft window light catching freckles on her cheeks, green eyes warming as she smiles. Final shot: a slow dolly-out reveals the cozy industrial interior — vinyl records spinning, a chalkboard menu, raindrops streaking the window. Sound of espresso machine hissing, gentle rain on glass, soft indie acoustic guitar. Hyper-detailed textures: yarn weave, hair strands, crema bubbles, raindrop refraction — shot on RED Komodo 6K, anamorphic lenses, shallow depth of field, Kodak Portra color science."
},
"negative_prompt": {
"title": "ネガティブプロンプト",
"description": "動画に含めたくない要素です。",
"type": "string"
},
"duration": {
"title": "長さ",
"description": "動画の長さを秒単位で指定します。",
"type": "integer",
"minimum": 3,
"maximum": 15,
"default": 5
},
"aspect_ratio": {
"title": "アスペクト比",
"description": "生成動画の出力比率です。",
"type": "string",
"enum": [
"16:9",
"9:16",
"1:1"
],
"default": "16:9"
},
"cfg_scale": {
"title": "CFGスケール",
"description": "プロンプトを反映する強さです。",
"type": "float",
"minimum": 0,
"maximum": 1,
"default": 0.5
},
"sound": {
"title": "音声",
"description": "動画に同期する音声を生成します。",
"type": "boolean",
"default": true
},
"multi_prompt": {
"title": "マルチプロンプト",
"description": "場面の移り変わりや展開を導く追加のプロンプト区間です。multi_prompt内の各区間の長さの合計は、動画全体の長さと一致させてください。",
"type": "array",
"items": {
"prompt": {
"title": "プロンプト",
"description": "シーンの移行と進行をガイドする追加のプロンプト セグメント。",
"type": "string",
"format": "str"
},
"duration": {
"title": "間隔",
"description": "このプロンプト区間の長さ（秒）です。",
"type": "integer",
"format": "int_slider_with_range",
"minimum": 3,
"maximum": 15,
"default": 5
}
},
"maxItems": 20,
"minItems": 0
},
"shot_type": {
"title": "ショットタイプ",
"description": "編集モードを指定します。intelligentは範囲を自動判断するデフォルト設定、customizeは手動設定です。",
"type": "string",
"enum": [
"customize"
],
"default": "customize"
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "単一画像 URL"
},
"video": {
"type": "string",
"format": "uri",
"description": "単一動画 URL"
},
"images": {
"type": "array",
"description": "複数画像 URL",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "複数動画 URL",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfyは最高の ComfyUI プラットフォームです。次のものを提供しています: ComfyUIオンライン 環境とサービス、および ComfyUIワークフロー 魅力的なビジュアルが特徴です。 RunComfyはまた提供します AI Models, アーティストが最新のAIツールを活用して素晴らしいアートを作成できるようにする。