# Happy Horse 1.1 API Alibaba の Happy Horse 1.1 動画生成モデル向けの完全な API リファレンスです。 ## モデルバリアント この API は 3 つのモデルバリアントをサポートしています。 | モデル | ID | 説明 | | --------------------------------------- | ------------------------------------ | ---------------------------------------------------- | | **Happy Horse 1.1 Text to Video** | `happyhorse-1.1-text-to-video` | テキストプロンプトから直接動画を生成します | | **Happy Horse 1.1 Image to Video** | `happyhorse-1.1-image-to-video` | プロンプトの指示に従って 1 枚の先頭フレーム画像を動かします | | **Happy Horse 1.1 Reference to Video** | `happyhorse-1.1-reference-to-video` | 最大 9 枚の参照画像に基づいて動画を生成します | ## クイック比較 | 機能 | Text to Video | Image to Video | Reference to Video | | -------------- | ------------------------- | ------------------------- | ------------------------- | | 入力 | テキストプロンプト | 先頭フレーム画像 + プロンプト | 参照画像 + プロンプト | | 長さの範囲 | 3-15 秒 | 3-15 秒 | 3-15 秒 | | 解像度 | 720p、1080p（デフォルト 1080p） | 720p、1080p（デフォルト 1080p） | 720p、1080p（デフォルト 1080p） | | アスペクト比 | 9 種類の比率をサポート（デフォルト 16:9） | 非対応（入力画像に従います） | 9 種類の比率をサポート（デフォルト 16:9） | | Seed | 任意 | 任意 | 任意 | ### サポートされるアスペクト比（Text to Video と Reference to Video） | 比率 | 説明 | | ------ | ---------------------- | | `16:9` | 横向き（ワイドスクリーン） | | `9:16` | 縦向き（縦長） | | `3:4` | 標準の縦向き | | `4:3` | 標準の横向き | | `4:5` | 縦向き | | `5:4` | 横向き | | `1:1` | 正方形 | | `9:21` | 超縦長 | | `21:9` | 超横長 | ## Happy Horse 1.1 Text to Video ### エンドポイント ``` POST /api/v1/video/task ``` ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | | -------------- | ------ | ------------------------------------------------------------------ | | `model_name` | string | `"happyhorse-1.1-text-to-video"` である必要があります | | `prompt` | string | 動画生成プロンプト | | `duration` | number | 動画の長さ（秒、3-15） | | `resolution` | string | 出力解像度：`"720p"` または `"1080p"`（デフォルト `"1080p"`） | | `aspect_ratio` | string | 動画のアスペクト比（上の表を参照。デフォルト `"16:9"`） | #### 任意 | パラメータ | 型 | 説明 | | ---------- | ------ | ---------------------------------------------------------------------------------- | | `seed` | number | 再現可能な生成のためのランダムシード。`0` から `2147483647` までの整数 | ### リクエスト例 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'happyhorse-1.1-text-to-video', prompt: 'A cat playing with a ball of yarn on a sunny windowsill', duration: 5, resolution: '1080p', aspect_ratio: '16:9', seed: 42, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Happy Horse 1.1 Image to Video ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | | ------------ | ------ | ------------------------------------------------------------------ | | `model_name` | string | `"happyhorse-1.1-image-to-video"` である必要があります | | `prompt` | string | 動画生成プロンプト | | `duration` | number | 動画の長さ（秒、3-15） | | `resolution` | string | 出力解像度：`"720p"` または `"1080p"`（デフォルト `"1080p"`） | | `image_url` | string | 先頭フレーム画像 URL（先頭フレームのみ） | #### 任意 | パラメータ | 型 | 説明 | | ---------- | ------ | ---------------------------------------------------------------------------------- | | `seed` | number | 再現可能な生成のためのランダムシード。`0` から `2147483647` までの整数 | > **注意:** image-to-video では `aspect_ratio` はサポートされません。出力のフレーミングはアップロードされた先頭フレーム画像に従います。 ### リクエスト例 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'happyhorse-1.1-image-to-video', image_url: 'https://example.com/first-frame.jpg', prompt: 'Gentle motion; cinematic lighting', duration: 5, resolution: '1080p', seed: 42, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Happy Horse 1.1 Reference to Video ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | | -------------- | -------- | ------------------------------------------------------------------ | | `model_name` | string | `"happyhorse-1.1-reference-to-video"` である必要があります | | `prompt` | string | 動画生成プロンプト。プレースホルダーを含まない通常のプロンプトを記述するか、任意で @ (AT) 参照機能を使用し、`<<>>` で `images` 配列の項目を明示的に参照できます | | `duration` | number | 動画の長さ（秒、3-15） | | `resolution` | string | 出力解像度：`"720p"` または `"1080p"`（デフォルト `"1080p"`） | | `aspect_ratio` | string | 動画のアスペクト比（上の表を参照。デフォルト `"16:9"`） | | `images` | string[] | 参照画像 URL（1-9 枚の画像） | #### @ (AT) 参照プレースホルダー @ (AT) 参照機能は、番号付きの `<<>>` プレースホルダーを通じて参照画像をプロンプトに関連付けます。番号は `1` から始まり、`images` 配列の順序に従います。 | プレースホルダー | 参照値 | |-------------|------------------| | `<<>>` | `images[0]` | | `<<>>` | `images[1]` | | `<<>>` | `images[2]` | #### 任意 | パラメータ | 型 | 説明 | | ---------- | ------ | ---------------------------------------------------------------------------------- | | `seed` | number | 再現可能な生成のためのランダムシード。`0` から `2147483647` までの整数 | ### 参照画像の要件 - サポート形式：`JPEG`、`JPG`、`PNG`、`WEBP` - 最大ファイルサイズ：画像 1 枚あたり 20 MB - 最短辺：400 px - 枚数：少なくとも 1 枚、最大 9 枚の画像 ### リクエスト例 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'happyhorse-1.1-reference-to-video', prompt: 'Subject moves naturally while preserving reference style and appearance', duration: 5, resolution: '1080p', aspect_ratio: '16:9', images: [ 'https://example.com/ref-1.jpg', 'https://example.com/ref-2.jpg', ], seed: 42, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ### @ (AT) Reference-to-Video リクエスト例 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'happyhorse-1.1-reference-to-video', prompt: 'Show the person from <<>> walking beside the bicycle from <<>> through the street in <<>>, preserving all reference details', duration: 5, resolution: '1080p', aspect_ratio: '16:9', images: [ 'https://example.com/person-reference.jpg', 'https://example.com/bicycle-reference.jpg', 'https://example.com/street-reference.jpg', ], seed: 42, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## レスポンス形式 ### 初回レスポンス ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### ポーリングレスポンス ステータスを確認するには `GET /api/v1/video/{taskId}` をポーリングします。 ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### ステータス値 - `submitted`: タスクが受け付けられ、処理待ちです - `processing`: 動画生成が進行中です - `succeed`: 動画生成が完了しました - `failed`: 動画生成に失敗しました ## 処理時間 通常の処理時間は、長さとキューの負荷に応じて 2-5 分です。 ## ベストプラクティス 1. **動きを明確に記述する**: 被写体の動き、カメラワーク、シーンの進行を追加して、動画のダイナミクスを改善します。 2. **まず短い反復を使う**: 長いクリップを実行する前に、3-5 秒の生成から始めてプロンプトの方向性を検証します。 3. **適切な入力画像を選ぶ**: image-to-video では、明瞭で十分に明るく、被写体にしっかり焦点が合った先頭フレーム画像を使用します。 4. **参照画像を厳選する**: reference-to-video では、保持したい被写体またはスタイルを明確に表す、一貫性のある高品質な参照画像を提供します。 5. **バリアントではシードを再利用する**: プロンプトの改善をテストするときは同じ `seed` を保ち、出力をより一貫して比較します。 6. **配信チャネルに比率を合わせる**: 横向き動画には `16:9`、ショート動画や Reels には `9:16`、正方形の配置には `1:1` を使用します。