# Pixverse V6 API Pixverse V6 動画生成モデルの完全な API リファレンスです。すべてのバリアントは統一された動画タスクエンドポイントを使用します。 ## モデルバリアント | モデル | ID | 説明 | | ----- | --- | ----------- | | **Pixverse V6 Text to Video** | `pixverse-v6-text-to-video` | テキストプロンプトから動画を生成 | | **Pixverse V6 Image to Video** | `pixverse-v6-image-to-video` | 1 枚のファーストフレーム画像からアニメーションを生成 | | **Pixverse V6 Transition** | `pixverse-v6-transition` | ファーストフレーム画像とラストフレーム画像の間のトランジションを生成 | | **Pixverse V6 Extend** | `pixverse-v6-extend` | `prompt` のガイドに従って既存動画を新しいフレームで延長 | ## クイック比較 | 機能 | Text to Video | Image to Video | Transition | Extend | | ------- | ------------- | -------------- | ---------- | ------ | | `prompt` | 必須 | 必須 | 必須 | 必須 | | `aspect_ratio` | 任意(デフォルト `16:9`);対応比率は下記参照 | 使用しない(入力画像に従う) | 使用しない(入力画像に従う) | 使用しない(入力動画に従う) | | `image_url` | — | 必須 | 必須(ファーストフレーム) | — | | `image_end_url` | — | — | 必須(ラストフレーム) | — | | `video_url` | — | — | — | 必須(ソース動画) | | `negative_prompt` | — | — | 任意 | 任意 | | `seed` | — | — | 任意(`0` は製品デフォルトとして扱われます) | 任意 | | 長さ | 1–15 秒 | 1–15 秒 | 1–15 秒 | 1–15 秒 | | 解像度 | `360p`, `540p`, `720p`, `1080p` | 同じ | 同じ | 同じ | | 音声 | `sound` で任意指定 | `sound` で任意指定 | `sound` で任意指定 | `sound` で任意指定 | Text-to-video モデルは次のアスペクト比をサポートします:`21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`。 ## Pixverse V6 Text to Video ### エンドポイント ``` POST /api/v1/video/task ``` ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | | --------- | ---- | ----------- | | `model_name` | string | `"pixverse-v6-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-v6-text-to-video', prompt: 'A cinematic street scene at night with neon reflections', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Image to Video ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | | --------- | ---- | ----------- | | `model_name` | string | `"pixverse-v6-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-v6-image-to-video', prompt: 'Fluid camera pan; maintain subject identity', duration: 6, resolution: '720p', image_url: 'https://example.com/first-frame.jpg', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Transition **ファースト**キーフレーム画像と**ラスト**キーフレーム画像の間の動きを生成します。任意の negative prompting と seed をサポートします。 ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | | --------- | ---- | ----------- | | `model_name` | string | `"pixverse-v6-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 | 動画用の音声を生成するかどうか | | `negative_prompt` | string | 出力で避けたい内容 | | `seed` | integer | ランダム性のシード;`0` はプラットフォームのデフォルトランダム動作に従います | ### リクエスト例 ```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-v6-transition', prompt: 'Seamless blend with natural lighting continuity', duration: 6, resolution: '720p', image_url: 'https://example.com/start.jpg', image_end_url: 'https://example.com/end.jpg', sound: true, negative_prompt: 'blur, watermark, text overlay', seed: 0, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Extend 既存クリップを継続します。ソース動画 URL と、ストーリーをどのように進めるかを説明するプロンプトを指定します。 ### リクエストパラメータ #### 必須 | パラメータ | 型 | 説明 | | --------- | ---- | ----------- | | `model_name` | string | `"pixverse-v6-extend"` である必要があります | | `prompt` | string | 動画をどのように継続するかを説明します | | `duration` | integer | 動画の長さ(秒)(`1`–`15`) | | `resolution` | string | `360p`, `540p`, `720p`, `1080p` のいずれか | | `video_url` | string | 延長するソース動画の URL | #### 任意 | パラメータ | 型 | 説明 | | --------- | ---- | ----------- | | `sound` | boolean | 動画用の音声を生成するかどうか | | `negative_prompt` | string | 出力で避けたい内容 | | `seed` | integer | ランダム性のシード;`0` はプラットフォームのデフォルトランダム動作に従います | ### リクエスト例 ```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-v6-extend', prompt: 'Continue the walk into the forest clearing', duration: 5, resolution: '720p', video_url: 'https://example.com/source-clip.mp4', sound: false, negative_prompt: 'low quality, jitter', seed: 0, }), }); 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. **Extend**:モデルがアーティファクトなしで動きを継続できるよう、クリーンで安定したソース動画を使用します。 2. **Transition**:再現可能なトランジションテストが必要な場合は、`negative_prompt` と `seed` を組み合わせます。 3. **解像度**:`resolution` を納品ターゲットに合わせます。高い解像度ほど処理に時間がかかります。 4. **ポーリング**:`task_status` が `succeed` または `failed` になるまで、5–10 秒ごとにポーリングします。