Skip to main content
HappyHorse 1.1 T2V の API リファレンスです。HappyHorse 1.1 のテキストから動画への生成は、プロンプトのみから、同期したセリフ、エフェクト、音楽を備えた短いビデオを作成します。

クイックスタート

Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk と npm install @comfyorg/sdk)を使用しています。cURL のスニペットは、同じ呼び出しを raw HTTP で行うものです。 モデル ID: wan/happyhorse-1.1-t2v エンドポイント: POST https://api.comfy.org/v2/models/wan/happyhorse-1.1-t2v
同じリクエストボディを POST https://api.comfy.org/v2/models/wan/happyhorse-1.1-t2v/requests に送信します。Router は実行が受け付けられるとすぐに 201 と request_id を返し、結果は準備ができ次第、このプロセスからでも別のプロセスからでも収集できます。キュー配信では、ステータス、キャンセル、収集の流れを説明します。

スキーマ

入力

object
必須
プロンプトワードなどの基本情報を入力します。
string
オーディオファイルのダウンロードURL。サポートされる形式: mp3、wav。reference_video_urls と併用できません。
string
先頭フレームの画像URL、または Base64 エンコードされたデータ。wan2.5-i2v-preview および wan2.6-i2v モデルでのみ必須です。happyhorse-1.x の i2v 表記は、ここでは先頭フレームを受け取りません。先頭フレームは type が first_frame の media 要素として渡します (下記 media を参照)。wan2.6-i2v で成功する img_url のボディは、happyhorse-1.0-i2v および happyhorse-1.1-i2v ではプロバイダーに拒否されます。画像形式: JPEG、JPG、PNG、BMP、WEBP。解像度: 360~2000 ピクセル。ファイルサイズ: 最大 10MB。
object[]
wan2.7、wan3.0、happyhorse-1.x モデル用のメディアアセットリスト。ビデオ生成のための参照素材(画像、オーディオ、ビデオ)を指定します。各要素は type と url フィールドを持ちます。 サポートされる type の値はモデルによって異なります:
  • wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip
  • wan2.7-r2v: reference_image、reference_video
  • wan2.7-videoedit: video、reference_image
  • wan3.0-video: first_frame(最大 1)、last_frame(最大 1)、reference_image(最大 10)、 reference_video(最大 5 クリップ、合計再生時間 <= 15 秒)、reference_audio(最大 5 クリップ、 合計再生時間 <= 15 秒)、file(最大 1、link と併用不可)、link(最大 1、file と 併用不可)。reference_*/file/link タイプと first_frame/last_frame タイプは 同一リクエスト内で同時に使用できません。配列の順序が、プロンプト内のアセットの 参照順序(Image 1、Video 1、Audio 1…)を定義します。
  • happyhorse-1.x-i2v: first_frame のみで、ちょうど 1 つ。少なくとも 300x300 ピクセル、 JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または data:{MIME_type};base64,… URL。 これらの表記は img_url を一切受け付けません。先頭フレームはここに渡します。
  • happyhorse-1.x-r2v: reference_image のみで、1〜9 枚。最短辺が少なくとも 400 ピクセル、最大 20MB、公開 URL または data: URL。reference_video はこの オペレーションの入力タイプではありません。
  • happyhorse-1.x-video-edit: video 上記のアセットごとの「最大 20MB」という数値は、最終的に受け取る画像に対する パートナー側の上限であり、アセットが公開 URL の場合はそのまま適用されます。 そのバイト列が Comfy を経由しないためです。インラインの data: URL は Comfy を 経由するため、転送の上限にも掛かります。Comfy Router の POST ボディは合計で 100 MiB に制限され、それを超えると 413 が返されます。また base64 はペイロードを 約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、 ここに示すパートナーのルールに到達する前に拒否されます。そのサイズであれば、 パートナー自身が定める 20MB の上限いっぱいの単一アセットでもインラインで余裕を もって収まるため、アセット 1 つについてはパートナーのルールが効きます。転送の 上限は、それらが複数にわたる場合に効きます。100 MiB の Router の上限は各要素では なくリクエスト全体を制限するためです。これらの上限に近いものは公開 URL として 送信してください。
string
必須
メディアアセットのタイプ指定可能な値: first_frame、last_frame、driving_audio、first_clip、reference_image、reference_video、reference_audio、video、file、link
string
必須
メディアファイルの URL。公開 HTTP/HTTPS URL、OSS の一時 URL、または (上記 media の説明にある該当モデルの項目が対応を認めている場合、たとえば happyhorse-1.x の i2v と r2v の表記のように) インラインの data:{MIME_type};base64,... URL です。モデルごとのサイズとピクセルの下限、およびインラインペイロード全体を制限する 100 MiB の Router リクエストボディ上限については、その説明を参照してください。
string
ネガティブプロンプトワードは、ビデオ画面に表示したくない内容を記述するために使用します
string
テキストプロンプトワード。中国語と英語をサポートし、長さは 800 文字以内です (wan3.0-video では最大 20,000 文字。上限を超えた内容は切り捨てられます)。 複数の参照ビデオを使用する wan2.6-r2v では、「character1」「character2」などを使って、 参照ビデオの順序で被写体を参照します。例: 「Character1 sings on the roadside, Character2 dances beside it」 wan3.0-video の参照モードでは、「Image 1」「Video 1」「Audio 1」などを使って、 media 配列内の対応する順序でメディアアセットを参照します。
string[]
wan2.6-r2v モデル専用の参照ビデオ URL。1~3 個のビデオ URL の配列です。 入力の制限:
  • 形式: mp4、mov
  • 数量: 1~3 本のビデオ
  • 単一ビデオの長さ: 2~30 秒
  • 単一ファイルサイズ: 最大 30MB
  • audio_url と併用できません 参照の再生時間: 単一ビデオは最大 5 秒、2 本のビデオはそれぞれ最大 2.5 秒、3 本のビデオはそれに比例して短くなります。 課金: 実際に使用された参照再生時間に基づきます。
string
ビデオエフェクトテンプレート名。任意です。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。
string
呼び出すモデルのID。このコンポーネントでは制約されません。Comfy Router が POST /v2/models/wan/{model} の {model} パスセグメントから設定するため、Router の呼び出し元は省略します。POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis への直接の v1 呼び出しでは必須であり、受け入れられる表記の列挙は、そのオペレーション自身のコンポーネント WanVideoGenerationRequest に定義されています。
object
ビデオ処理パラメータ
boolean
デフォルト:"true"
ビデオにオーディオを追加するかどうか
string
デフォルト:"\"auto\""
wan2.7-videoedit モデル用のビデオオーディオ設定。
  • auto(デフォルト): モデルがプロンプトのコンテンツに基づいてインテリジェントに判断します
  • origin: 入力ビデオのオリジナルオーディオを強制的に保持します 指定可能な値: auto, origin
integer
デフォルト:"5"
生成されるビデオの再生時間(秒):
  • wan2.5 モデル: 5 秒または 10 秒
  • wan2.6-t2v、wan2.6-i2v: 5、10、または 15 秒
  • wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非サポート)
  • wan2.7-i2v、wan2.7-t2v: [2, 15] の範囲の整数
  • wan2.7-r2v、wan2.7-videoedit: [2, 10] の範囲の整数
  • wan3.0-video: ビデオ入力なしの場合は [2, 30] の範囲の整数。ビデオ入力を使用する場合、 入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると モデルが適切な再生時間を選択するスマート再生時間モードが有効になります 範囲: -1 から 30
boolean
デフォルト:"true"
プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true です
string
生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 wan2.7 モデルの場合、指定しないと解像度ティアに基づいてデフォルトが決まります。 wan3.0-video の場合、adaptive(デフォルト)は入力メディアの比率と意図に基づいて 適切なアスペクト比を自動的に推奨します。指定可能な値: adaptive, 16:9, 9:16, 1:1, 4:3, 3:4
string
解像度レベル。対応する値はモデルによって異なります:
  • wan2.5-i2v-preview: 480P、720P、1080P
  • wan2.6-i2v: 720P、1080P のみ(480P 非サポート)
  • wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P)
  • wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上流のデフォルト 1080P) このプロキシは、resolution も size も指定されていないビデオ生成リクエストを拒否します。 解像度ティアが課金レートを決定するためです。 指定可能な値: 480P, 720P, 1080P
integer
乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します範囲: 0 から 2147483647
string
デフォルト:"\"single\""
インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 wan2.6 および wan2.7-r2v モデル用。
  • single: シングルショットビデオ(デフォルト)
  • multi: マルチショットビデオ 指定可能な値: multi, single
string
widthheight 形式のビデオ解像度。対応解像度はモデルによって異なります: wan2.5 T2V の場合: 480P (480832, 832480, 624624)、720P、1080P サイズ wan2.6 T2V/R2V の場合 (480P なし): 720P: 1280720, 7201280, 960960, 1088832, 8321088 1080P: 19201080, 10801920, 14401440, 16321248, 12481632
boolean
デフォルト:"false"
ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます
GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しの検証に使用されるものと同じドキュメントです。

出力

object
必須
string
インテリジェントな書き換え後の実際のプロンプト(ビデオタスク用)
string
オーディオ生成を伴う I2V タスク用のオーディオ URL
string
失敗したリクエストのエラーコード(リクエストが成功した場合は返されません)
string
タスクの完了時間
string
失敗したリクエストの詳細情報(リクエストが成功した場合は返されません)
string
オリジナルの入力プロンプト(ビデオタスク用)
object[]
画像生成タスクのタスク結果のリスト
string
インテリジェントな書き換え後の実際のプロンプト(有効な場合)
string
画像のエラーコード(一部のタスクが失敗した場合に返されます)
string
画像のエラー情報(一部のタスクが失敗した場合に返されます)
string
オリジナルの入力プロンプト
string
生成済み画像の URL アドレス
string
タスクの実行時間
string
タスクの送信時間
string
必須
タスク ID
object
画像生成タスクのタスク結果統計
integer
失敗したタスクの数
integer
成功したタスクの数
integer
タスクの総数
string
必須
タスクのステータス可能な値: PENDING、RUNNING、SUCCEEDED、FAILED、CANCELED、UNKNOWN
string
完了したビデオ生成タスクのビデオ URL。リンクの有効期間は 24 時間
string
必須
一意のリクエスト識別子
object
出力情報の統計。成功した結果のみがカウントされます
integer
ビデオ解像度レベル(I2V および wan3.0-video タスク)
number
生成されたビデオの再生時間(秒)(I2V および wan3.0-video タスク)
integer
生成されたビデオのフレームレート(wan3.0-video タスク)
integer
生成された画像の数(T2I および I2I タスク)
number
入力ビデオの再生時間(秒)。ビデオ入力がない場合は 0.0(wan3.0-video タスク)
number
出力ビデオの再生時間(秒)(wan3.0-video タスク)
string
生成されたビデオのアスペクト比。例: 16:9(wan3.0-video タスク)
string
画像の解像度(T2I および I2I タスク)
integer
生成されたビデオの数(T2V タスク)
number
生成されたビデオの再生時間(秒)(T2V タスク)
string
ビデオの解像度比率(T2V タスク)
string
失敗したリクエストのエラーコード。output の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。
string
失敗したリクエストの詳細情報。output の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。output.message にフォールバックする前に、これを確認してください。

例

入力

出力

ビデオ URL の有効期限は 24 時間です。保存が必要な場合は、速やかにビデオをダウンロードしてください。

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。 リクエストが失敗すると、Router は理由を説明する X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味し、413 はリクエスト本文が Router の受け入れ可能なサイズを超えていたことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。 上記のフィールド説明に記載されているサイズ制限は、プロバイダーの仕様から引用した、そのフィールドに対するプロバイダー自身の上限です。Router はリクエスト本文全体に対して別の上限を適用し、base64 エンコードされたメディアもこれにカウントされます。リクエスト本文のサイズ を参照してください。 このページは、Comfy Router 経由で呼び出す 1 つのパートナーモデルについて説明しています。同じ comfy-sdk / @comfyorg/sdk パッケージには、Comfy Cloud 上で ComfyUI のワークフローグラフ全体を実行するための 2 つ目のクライアントも含まれています: Comfy(api_key=...) / new Comfy({ apiKey })、および client.workflows、client.assets、client.jobs。Comfy SDKs を参照してください。

ヘッダー

認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。

Router API の利用

モデルの検出、バリデーションエラー、リトライ、課金。

制限事項

Router が現在対応していないことと、代替手段。