Pixverse C1 Reference to Video API の使い方:画像から動画生成統合ガイド(2026)
NamiFusion で Pixverse C1 Reference to Video API を呼び出す方法:パラメータ、料金、そのまま実行できるコード例、Playground で試用可能。
Pixverse C1 Reference to Video は PixVerse の画像から動画生成モデルです:PixVerse C1 リファレンス動画生成は、参考画像から特定のキャラクターや被写体の特徴を高度に固定し、新しい動的シーンへシームレスに融合、芸術性の高い一貫性のある動画を生成します。ブランドIP運用、映像プリビズ、デジタルマーケティングに最適です。エンタープライズ向けREST推論API、コールドスタートなし、圧倒的なパフォーマンスと手頃な価格を両立します。NamiFusion では Playground で試してから(送信前に見積もり表示)、統一 REST API で呼び出せます(1 回あたり約 $0.200)。
TL;DR
· タスク種別:画像から動画生成(提供:PixVerse)
· 料金:1 回あたり約 $0.200($1 = 100 クレジット)、従量課金
· 始め方:Playground で試用(送信前に見積もり)→ API キー作成 → POST 一発で統合
· 調整可能パラメータ:7 個(下表参照)
· プラットフォーム透かしなし。商用利用可(利用規約に従う)
Pixverse C1 Reference to Video で何が作れる?
ショート動画・広告クリップ:一文または 1 枚の画像から公開可能な動画素材を生成。
製品デモやコンセプトプレビュー:撮影前に絵コンテと方向性を低コストで検証。
SNS コンテンツ量産:縦型ショートを一括生成し、トレンドに素早く乗る。
既存素材の二次創作:画像→動画で静止画作品に命を吹き込み、寿命を延ばす。
この API はどう呼び出す?
1. NamiFusion に登録し、API Keys ページでキーを作成(登録で無料クレジット)。
2. 下記の cURL 例でタスクを送信。Bearer トークンにキーを指定。
3. 返された task_uuid でステータスをポーリングし、完了後に出力 URL を取得。
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/pixverse/pixverse-c1/reference-to-video" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"image_references": [
{
"type": "subject",
"image": "https://example.com/input.jpg"
}
],
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"duration": 5,
"resolution": "540p",
"aspect_ratio": "16:9",
"generate_audio_switch": false
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"どんなパラメータがある?
image_references(image_references):必須
prompt(Prompt):必須
duration(Duration):任意、デフォルト 5
resolution(Resolution):任意、デフォルト "540p"
aspect_ratio(Aspect Ratio):任意、デフォルト "16:9"
generate_audio_switch(Generate Audio Switch):任意、デフォルト false
seed(Seed):任意
Pixverse C1 Reference to Video のプロンプトの書き方は?
1. 主体を先に:主役と動作を先に書き、環境・光・スタイルを後から足す(「雨のネオン街を走る宇宙飛行士、シネマティック、浅い被写界深度」)。
2. 形容詞の羅列より具体名詞:「85mm ポートレートレンズ、夕暮れの逆光」は「とても綺麗、超高品質」より遥かに効く。
3. 1 回の反復で変えるのは 1 変数だけ:seed を固定して再現し、語句を 1 つずつ調整する。
4. 否定は肯定で書く:「ぼかさない」ではなく「シャープなフォーカス、精細なディテール」と指定。
料金はいくら?
従量課金(クレジット制)。1 回あたり約 $0.200($1 = 100 クレジット)。解像度や長さなどで変動し、Playground では送信前に正確な見積もりが表示されます。
Pixverse C1 Reference to Video
参照画像をもとに、被写体と背景の一貫性を保った動画を高精度に生成。
Pixverse C1 Reference to Video は、参照画像を活用して一貫性の高い動画を生成できる画像から動画へのモデルです。プロンプト内で @ref_name を使うことで、キャラクター、オブジェクト、背景の出現内容を明確に指定できます。360p からネイティブ 1080p までの解像度、1~15 秒の長さ、複数のアスペクト比、音声のオプション生成に対応しており、さらにコールドスタートなしで快適に利用できます。
🚀 主な特長
- 複数参照画像に対応:1~7 枚の参照画像をアップロードし、キャラクター、商品、背景、オブジェクトを1本の動画内で組み合わせられます。
- 被写体と背景を個別に制御:各参照画像を
subjectまたはbackgroundとして指定でき、構図や合成の精度を高められます。 @ref_nameによる明示的な参照:プロンプト内で@ref_nameを使い、どの要素をどこに登場させるかを細かく制御できます。- 高いキャラクター一貫性:参照した人物やオブジェクトの見た目を動画全体で維持しやすく、シリーズ制作やブランド用途に適しています。
- 柔軟な出力設定:360p、540p、720p、1080p に対応し、プレビューから本番納品まで幅広いワークフローに対応します。
- ネイティブ音声生成に対応:必要に応じて音声生成を有効化し、環境音を含む没入感のある動画を作成できます。
- コールドスタートなし:繰り返し生成や高速な試行錯誤に適した、実運用向けのレスポンス性能を備えています。
🛠️ 技術仕様
| 項目 | 内容 |
|---|---|
| モデル名 | Pixverse C1 Reference to Video |
| モデル ID | pixverse/pixverse-c1/reference-to-video |
| モデルアーキテクチャ | 参照画像ガイド型の画像から動画へのモデル |
| 入力 | プロンプト + 1~7 枚の参照画像 |
| 参照タイプ | subject、background |
| プロンプト参照方法 | @ref_name を使ってアップロード画像を指定 |
| 出力形式 | 動画(音声は任意) |
| アスペクト比 | 16:9、4:3、1:1、3:4、9:16、2:3、3:2、21:9 |
| 解像度 | 360p、540p、720p、1080p |
| 長さ | 1~15 秒(デフォルト:5 秒) |
| 音声 | オプション対応 |
| シード値 | 再現性向上のため利用可能 |
| レイテンシ | コールドスタートなし。高速な反復生成に適しています |
| 想定出力 | 参照一貫性を重視したシネマティックな短尺動画 |
サンプルプロンプト
@hero が夜の @city_bg を駆け抜ける。シネマティックな照明、ネオンの反射、ダイナミックなカメラモーション。@product を @studio_bg の中でゆっくり回転させる。高級感のある商用ライティング、クリーンな広告スタイル。@character が @park_bg で @pet と触れ合う。暖かな午後の日差し、自然な動き、やわらかな映画的構図。
💰 価格
| 解像度 | 音声なし | 音声あり |
|---|---|---|
| 360p | $0.030/秒 | $0.040/秒 |
| 540p | $0.040/秒 | $0.050/秒 |
| 720p | $0.050/秒 | $0.065/秒 |
| 1080p | $0.095/秒 | $0.120/秒 |
課金は生成された動画の秒数単位で計算されます。対応する長さは 1~15 秒です。基本価格は $0.05 です。
FAQ
無料で試せますか?+
登録で無料クレジットが付与されますが、現在はアプリ内の一部の顔交換機能のみに適用されます。本モデルは従量課金です。Playground ではコードなしで試せ、送信前に正確な見積もりが表示されます。
生成物は商用利用できますか?ウォーターマークは?+
商用利用できます。NamiFusion はプラットフォームのウォーターマークを付けません。利用規約と適用法に従ってください。
コンテンツポリシーは?+
NamiFusion は無検閲エンジンで恣意的な制限はなく NSFW にも対応しますが、違法コンテンツと本人の同意のない実在人物素材は禁止です。詳細は利用規約へ。
Pixverse C1 Reference to Video のタスクはどれくらいかかる?+
パラメータ次第で、画像は数秒〜数十秒、動画は数十秒〜数分。API は task_uuid を返すのでポーリングできます。
解像度・長さの上限は?+
上のパラメータ表を参照してください。各モデルの解像度・長さの選択肢はパラメータ説明と Playground に記載されています。