澜姿とは
澜姿は単独で動作するポーズスタジオであり、DeepSeek Harnessのプラグインでもあります。ai-pose-gallery-zhに収録された288組、1,439枚のポーズ線画から1つ以上のポーズを選び、キャラクターと衣装の参考画像を組み合わせて、同じモデルのさまざまな動作の画像を生成します。
プロジェクトではデフォルトで、コミュニティのクジラ娘の成人キャラクター大肥魚をモデルとして使用します。長いウェーブの青髪、クジラの耳、シロナガスクジラの尾を持ち、デフォルトではネイビーブルーと白のメイド服を着ています。最大3枚の別のモデル写真を読み込み、キャラクターの顔や衣装を置き換えることもできます。
ポーズ線画は身体の姿勢を説明するためだけに使用され、デフォルトでは線画に描かれた空白の身体を最終画像に描き込みません。線画はプロジェクトのリポジトリには保存されず、必要に応じて公開画像ホスティングサービスから読み込まれます。
主な機能
- 豊富なポーズライブラリ：288組、1,439枚のポーズ線画を収録し、単一選択と複数選択に対応しています。
- 衣装の差し替え：COSTUME-DB-01の1,407種類の衣装から1つを選択し、キャラクターの顔、髪型、クジラの耳、クジラの尾を維持できます。
- カスタムモデル：最大3枚のモデル写真を読み込めます。デフォルトの大肥魚を使い続けることもできます。
- 複数の画像生成API：Volcengine Ark Seedream、Gemini、OpenAI互換APIに対応しています。
- APIキーなしのワークフロー：APIキーを設定していなくても完全なプロンプトを生成でき、
dsh-image-genにコピーして使用できます。 - Harness連携：プラグインをインストールすると、サイドバーから完全なスタジオを開けるほか、Agentにポーズ検索、衣装検索、画像生成を実行させられます。
- レスポンシブUI：ワイド画面では複数列レイアウト、狭い画面では1列レイアウトになり、画像生成ボタンは下部に保持されます。
ローカルスタジオを起動する
1. 環境を準備する
澜姿にはNode.js 22.19以降が必要です。Node.jsのバージョンが要件を満たしていることを確認し、プロジェクトディレクトリで依存関係をインストールして開発サーバーを起動します。
npm install
npm run dev起動後、ブラウザでhttp://127.0.0.1:43123を開きます。
2. ポーズを選択する
スタジオ中央のエリアでポーズを選択します。一度に複数のポーズを選ぶと、システムがそれぞれに対応する画像を個別に生成します。標準的な全身ポーズはデフォルトで表示されます。セクシー系と2人用のポーズはデフォルトでは表示されないため、成人向けスイッチを明示的にオンにする必要があります。
3. 衣装を選択する
衣装ページに切り替えると、1着の衣装を選択できます。春、夏、秋、冬、パーティーのカテゴリはデフォルトで表示されます。下着、水着、セクシーのカテゴリは、成人向けポーズと同じスイッチを使用します。
衣装を選択すると、生成結果ではその衣装が使われ、キャラクターの顔、髪型、その他の特徴ができるだけ維持されます。このとき、デフォルトの衣装を維持オプションは一時的に選択した衣装に置き換えられます。
4. モデルを設定または変更する
左側のエリアでモデルを管理します。デフォルトの大肥魚を使い続けることも、最大3枚の自分のモデル写真を読み込むこともできます。複数の参考画像は、キャラクターの顔、髪型、衣装の情報を提供するのに役立ちますが、実際の結果は使用する画像生成モデルにも左右されます。
5. 画像生成APIを設定する
右上の画像生成設定を開き、GeminiまたはOpenAI互換APIに必要なキーを入力します。キーは現在のブラウザ内にのみ保存され、プロジェクトデータとしてリポジトリに書き込まれることはありません。
澜姿は次のデフォルト設定に対応しています。
- Seedream：Volcengine Arkのエンドポイント
https://ark.cn-beijing.volces.com/api/v3を使用し、デフォルトモデルはdoubao-seedream-5-0-flash-260915です。 - Gemini：デフォルトモデルは
gemini-2.5-flash-imageです。 - OpenAI互換API：まず
images/editsを呼び出します。APIが編集に対応していない場合はテキストのみの生成に切り替え、参考画像が送信されなかったことを結果に表示します。
Seedreamにはモデル画像、任意の衣装画像、ポーズ線画がまとめて送信されます。衣装を選択した場合、参考画像の順序はキャラクター、人物の写っていない衣装画像、ポーズ線画です。
6. 生成を開始する
モデル、ポーズ、衣装、APIの設定が完了したら、画像生成ボタンをクリックして生成します。キーを設定していなくても、右側には選択した各ポーズのプロンプトが生成されます。これらのプロンプトをコピーし、インストール済みのdsh-image-genに渡して生成できます。
サーバー側でキーを設定する
キーをブラウザに入力したくない場合は、環境変数でサーバープロセスにプロバイダー、モデル、エンドポイント、キーを設定できます。
POSE_MUSE_PROVIDER=seedream \
POSE_MUSE_MODEL=doubao-seedream-5-0-flash-260915 \
POSE_MUSE_BASE_URL=https://ark.cn-beijing.volces.com/api/v3 \
POSE_MUSE_API_KEY=あなたのキー \
npm run devこの方法は、固定マシンや管理された環境にスタジオをデプロイする場合に適しています。起動後、フロントエンドはブラウザにキーを保存せず、サーバーが提供する画像生成設定を直接使用できます。
DeepSeek Harnessにインストールする
マシンにDeepSeek Harnessがすでにインストールされている場合は、澜姿をプラグインとしてwebプロファイルに追加できます。
dsh plugin --profile web add gen-ai-pose-imageプラグインのパッケージ名はgen-ai-pose-imageです。パッケージがまだ公開されていない場合や、ローカルの変更をデバッグする場合は、パッケージ名をリポジトリのローカルパスに置き換えられます。インストール後、該当するプロファイルを再起動します。
再起動すると、左側のサイドバーに澜姿 / スタジオの入口が追加され、プラグインや自動化タスクと並んで表示されます。開くと、同じページでモデル、ポーズ、衣装の選択、画像生成設定の調整、結果の確認ができます。
Agentから澜姿のツールを呼び出す
プラグインはAgentに3つのツールを提供します。
search_poses：条件に合うポーズを検索します。search_costumes：衣装を検索します。generate_pose_images：選択した内容に基づいてポーズ画像を生成します。
衣装を変更する場合は、衣装番号をcostume_idに渡します。HarnessプロセスにPOSE_MUSE_API_KEYが設定されていれば、ツールが画像を直接生成してセッションに添付します。キーがない場合は、準備済みのプロンプトを返すため、dsh-image-genのgenerate_imageまたはedit_imageに引き続き渡せます。
成人向けポーズと成人向け衣装は、デフォルトでは検索結果に表示されません。ユーザーが明示的に要求した場合のみ、
search_posesまたはsearch_costumesにinclude_adult: trueを渡してください。
モバイルと狭いパネルでの使用
澜姿はレスポンシブレイアウトに対応しています。狭い画面ではモデルエリアが上部に折りたたまれ、ポーズカテゴリはドロップダウン選択に変わり、画像生成ボタンはページ下部に固定されます。衣装カテゴリは自動的に折り返され、カードの説明も表示領域内に収まります。
Harnessの狭いパネルでも、元の複数列スタジオは同じように1列へ折りたたまれるため、専用のモバイル版に切り替える必要はありません。
応用的な使用方法
複数ポーズ生成を整理する
澜姿では複数のポーズを同時に選択できます。動作を比較したい場合は、まずモデルと衣装を固定してから一連のポーズを選び、まとめて生成すると、同じキャラクターの異なる姿勢での一貫性を確認しやすくなります。
衣装参考画像の役割を理解する
衣装ライブラリの画像には人物が写っておらず、主に衣装の外観を提供します。衣装を選択すると、澜姿はキャラクターの参考画像、衣装の参考画像、ポーズ線画を同時に組み合わせます。APIが画像編集に対応せずテキストのみの生成に切り替わった場合、参考画像は送信されず、結果ページにそのことが明示されます。
まずプロンプトでフローを確認する
利用可能なAPIキーがない場合は、先にポーズ、モデル、衣装を選択し、右側に生成されたプロンプトを確認してから、別の画像生成ツールにコピーできます。これにより、正式なAPIを設定する前にワークフローを検証できます。
プロジェクトのチェックを実行する
ローカルコードを変更した後やコミットを準備する前に、テストと型チェックを実行できます。
npm test
npm run typecheck著作権と使用制限
澜姿自体のプログラムはMIT Licenseで提供されていますが、このライセンスはプログラムコードにのみ適用され、ポーズ、衣装、キャラクターの参考画像には自動的に適用されません。
- ポーズ線画と元データの著作権はギアに帰属し、上流の説明ではこれらの画像を商用利用できないとされています。
- 衣装画像はギアの衣装集 COSTUME-DB-01に由来し、リポジトリには番号とキーワードのみ保存されています。
- 大肥魚の設定画像はdeepseek-whale-girlに由来し、作者はTreapGoGoです。対応するリポジトリのMITライセンスに従って使用されます。
- 大肥魚はコミュニティのキャラクターであり、深度求索を代表するものではありません。DeepSeekは深度求索の商標であり、プロジェクトのライセンスはその商標の使用権を付与しません。
生成結果を公開または使用する前に、プロジェクト内のshared/license.mjsとLICENSEを確認し、各素材に個別に適用されるライセンスと使用制限を遵守してください。
まとめ
澜姿は、キャラクターの参考画像、ポーズ線画、人物の写っていない衣装画像、画像生成APIを1つのスタジオに統合します。ローカルですばやくポーズと衣装を選択できるほか、プラグインをDeepSeek Harnessにインストールして、Agentに素材の検索と画像生成を実行させることもできます。使い始める際は、まずローカルスタジオを起動してフローを確認し、実際に使用するAPIに応じてブラウザまたはサーバー側のキーを設定してください。