AIキャラクター一貫性API — シーン間でのキャラクター同一性保持
利用可能40以上のキャラクター一貫性モデルを1つのAPIキーでMuapiのキャラクター一貫性APIは、1枚以上の参照画像から被写体の外見、衣装、トーン、画風を把握し、新しい画像や動画シーン間で同一キャラクターを再現します。
MiniMax Subject Reference
単一の参照画像から被写体の外見を新しいシーンに引き継ぐ低コストな単一参照エンドポイント。
Wan 3.0 Reference to Video
大規模な参照画像パックを用いて被写体の同一性と視覚的連続性を精密に誘導。
Veo 3.1 Reference to Video
映画的なカメラワークと被写体維持を両立させたプレミアムな参照動画生成。
Kling O1 Reference to Video
複数アングルのビューとディレクター指示から一貫した動画被写体を構築。
MiniMax H3 Reference to Video
当角色的外观、動作和声音都很重要時，组合視觉和時间参考。
Seedance 2.5 オムニリファレンス
複雑なキャラクターパックや複数アングルに対応した大容量リファレンスエンドポイント。
角 とは？色一致性 API とは？
キャラクター一貫性APIは、1枚以上の参照画像を使用して被写体の顔、体型、衣装、画風を捉え、新しい画像生成や動画シーンでもその被写体を認識可能な状態で再現します。
Muapiは画像向けと動画向けのモデルファミリーを同一のREST送信・ポーリングフローで提供し、単一のAPIキーでシームレスに連携できます。
主な機能
図像参考生成
将角色源図转换として新的静帧，同時尽量保留面部特征、服装和視觉身份。
参考図转視频
参照された被写体を新しいアングルや動きを伴う動画シーンとしてアニメーション化できます。
已验证的参考図数量限制
各モデルが受け入れ可能な参照画像の上限（1枚〜30枚）をカタログで明示しており、用途に合わせた選定が容易です。
多模态参考
画像だけでなく、短い動画クリップや音声トラックも参照として受け入れるエンドポイントをサポート。
任务類型提示
明确传入模型要求的任务類型和参考図字段，减少异步任务失败并便于重试。
従量課金制
低コストな画像参照から開始し、プロダクション品質の参照動画生成へとスムーズにスケールアップできます。
代表性角色一致性モデル比較
| モデル | 供应商 | 价格 | 适合场景 |
|---|---|---|---|
| MiniMax Subject Reference | MiniMax | $0.01/次生成 | 最低成本的单図参考 |
| Ideogram Character | Ideogram | $0.15/次生成 | 一致的插画或写実静帧 |
| Seedance 2 Character | ByteDance | $0.18/次生成 | 一到三枚参考図 |
| Gemini Omni Character | 免费 | 免费的多模态図像参考 | |
| Vidu Q2 Reference | Vidu | $0.065/次生成 | 最大7枚の参照画像を用いた動画生成 |
| Wan 3.0 Reference to Video | Alibaba | $0.50/次生成 | 大規模な参照画像パックを用いた動画生成 |
| Veo 3.1 Reference to Video | $0.60/次生成 | 高级电影感参考镜頭 | |
| Seedance 2.5 オムニリファレンス | ByteDance | $1.70/次生成（720p） | 复杂多模态集合和连续性 |
参考図数量、支持的模态和价格因模型而异。提交生产请求前，请先查看各模型的 Playground Schema。
如何调用角色一致性 API
- 画像または動画モデルを選択。 根据输出類型、参考図数量、输入模态和预算選择模型。
- 托管参考文件。 POST /api/v1/upload_file 経由で元画像をアップロードするか、公開URLを指定します。
- 発送任务類型字段。 调用 POST /api/v1/{model-slug}，传入 images_list、提示词以及模型要求的参考図或任务類型字段。
- 轮询并保存结果。 ステータスが completed になるまで GET /api/v1/predictions/{request_id}/result を確認し、一貫したアセットを取得します。
curl -X POST https://api.muapi.ai/api/v1/seedance-2.5-omni-reference \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"images_list": [
"https://example.com/character-front.jpg",
"https://example.com/character-side.jpg"
],
"prompt": "the character walking through a neon-lit city street at night",
"omni_reference_task_type": "reference",
"duration": 5,
"aspect_ratio": "16:9"
}'import requests
response = requests.post(
"https://api.muapi.ai/api/v1/seedance-2.5-omni-reference",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"images_list": [
"https://example.com/character-front.jpg",
"https://example.com/character-side.jpg",
],
"prompt": "the character walking through a neon-lit city street at night",
"omni_reference_task_type": "reference",
"duration": 5,
"aspect_ratio": "16:9",
},
)
request_id = response.json()["request_id"]
result = requests.get(
f"https://api.muapi.ai/api/v1/predictions/{request_id}/result",
headers={"x-api-key": "YOUR_API_KEY"},
)
print(result.json())よくある質問
应该発送多少枚参考図 とは？
被写体の特徴を捉えるのに十分な最小限の参照パックを使用してください。通常は正面、斜め、側面の2〜4枚のクリアなアングル画像が最適です。
キャラクター一貫性モデルで動画を生成できますか？
はい。Vidu Q2、Wan 3.0、Veo 3.1、Kling O1、MiniMaxなどの参照対応動画モデルにより、キャラクターの一貫性を保った動画クリップを生成できます。
動画や音声をリファレンスとして使用できますか？
一部のマルチモーダルエンドポイントは、静止画だけでなく短い動画クリップや音声トラックを参照として受け付けます。
として什么我的异步参考任务失败了 とは？
常见原因包括参考図数量不支持、字段名称错误、URL 无法访問或缺少模型要求的任务類型。请检查 Playground Schema，并尝试减少参考図数量后重试。
角色一致性生成需要多少钱 とは？
料金は無料または$0.01の画像参照から、プレミアムな参照動画生成（生成1回あたり約$0.20〜$0.60）まで幅広く用意されています。
すべての参照モデルに1つのAPIキーでアクセスできますか？
はい。Muapiは共通のAPIキーと統一された送信・ポーリングフローを採用しており、モデルの切り替えも容易です。