# Pixverse C1 API Pixverse C1 動画生成モデルの完全な API リファレンスです。すべてのバリアントは統一された動画タスクエンドポイントを使用します。 ## モデルバリアント | モデル | ID | 説明 | | ----- | --- | ----------- | | **Pixverse C1 Text to Video** | `pixverse-c1-text-to-video` | テキストプロンプトから動画を生成 | | **Pixverse C1 Image to Video** | `pixverse-c1-image-to-video` | 1 枚のファーストフレーム画像からアニメーションを生成 | | **Pixverse C1 Transition** | `pixverse-c1-transition` | ファーストフレーム画像とラストフレーム画像の間のトランジションを生成 | ## クイック比較 | 機能 | Text to Video | Image to Video | Transition | | ------- | ------------- | -------------- | ---------- | | `prompt` | 必須 | 必須 | 必須 | | `aspect_ratio` | 任意(デフォルト `16:9`);対応比率は下記参照 | 使用しない(入力画像に従う) | 使用しない(入力画像に従う) | | `image_url` | — | 必須 | 必須(ファーストフレーム) | | `image_end_url` | — | — | 必須(ラストフレーム) | | 長さ | 1–15 秒 | 1–15 秒 | 1–15 秒 | | 解像度 | `360p`, `540p`, `720p`, `1080p` | 同じ | 同じ | | 音声 | `sound` で任意指定 | `sound` で任意指定 | `sound` で任意指定 | Text-to-video モデルは次のアスペクト比をサポートします:`21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`。 ## Pixverse C1 Text to Video ### エンドポイント ``` POST /api/v1/video/task ``` ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | | --------- | ---- | ----------- | | `model_name` | string | `"pixverse-c1-text-to-video"` である必要があります | | `prompt` | string | 動画生成プロンプト | | `duration` | integer | 動画の長さ(秒)(`1`–`15`) | | `resolution` | string | `360p`, `540p`, `720p`, `1080p` のいずれか | #### 任意 | パラメータ | 型 | 説明 | | --------- | ---- | ----------- | | `aspect_ratio` | string | デフォルト `16:9`。`21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3` のいずれか | | `sound` | boolean | 動画用の音声を生成するかどうか | ### リクエスト例 ```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: 'pixverse-c1-text-to-video', prompt: 'A drone shot over coastline at golden hour', duration: 5, resolution: '720p', aspect_ratio: '16:9', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse C1 Image to Video ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | | --------- | ---- | ----------- | | `model_name` | string | `"pixverse-c1-image-to-video"` である必要があります | | `prompt` | string | 動画生成プロンプト | | `duration` | integer | 動画の長さ(秒)(`1`–`15`) | | `resolution` | string | `360p`, `540p`, `720p`, `1080p` のいずれか | | `image_url` | string | ファーストフレーム画像の URL | #### 任意 | パラメータ | 型 | 説明 | | --------- | ---- | ----------- | | `sound` | boolean | 動画用の音声を生成するかどうか | ### リクエスト例 ```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: 'pixverse-c1-image-to-video', prompt: 'Slow zoom in; soft natural motion', duration: 5, resolution: '720p', image_url: 'https://example.com/first-frame.jpg', sound: false, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse C1 Transition **ファースト**キーフレーム画像と**ラスト**キーフレーム画像の間の動きを生成します。 ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | | --------- | ---- | ----------- | | `model_name` | string | `"pixverse-c1-transition"` である必要があります | | `prompt` | string | 2 つのフレーム間の動きを説明します | | `duration` | integer | 動画の長さ(秒)(`1`–`15`) | | `resolution` | string | `360p`, `540p`, `720p`, `1080p` のいずれか | | `image_url` | string | ファーストフレーム画像の URL | | `image_end_url` | string | ラストフレーム画像の URL | #### 任意 | パラメータ | 型 | 説明 | | --------- | ---- | ----------- | | `sound` | boolean | 動画用の音声を生成するかどうか | ### リクエスト例 ```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: 'pixverse-c1-transition', prompt: 'Smooth cinematic morph between the two scenes', duration: 6, resolution: '720p', image_url: 'https://example.com/start.jpg', image_end_url: 'https://example.com/end.jpg', sound: true, }), }); 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`: 動画生成に失敗しました ## ベストプラクティス 1. **解像度**:品質と生成時間のバランスには `720p` または `1080p` を使用し、より速い反復には `360p` または `540p` を使用します。 2. **トランジション**:モデルが動きを安定して補間できるよう、鮮明で十分に明るいファーストフレームとラストフレームを使用します。 3. **音声**:同期した環境音が必要な場合は `sound` を設定し、無音出力には省略するか `false` を設定します。 4. **ポーリング**:`task_status` が `succeed` または `failed` になるまで、5–10 秒ごとにポーリングします。