encode_vibe¶
参照画像を NovelAI の vibe トークン にエンコードします。vibe トークンは参照画像の
スタイル / アイデンティティをコンパクトに表現したもので、generate_image の
references パラメーターに渡せます (V4/V4.5 モデルのみ — V5 はまだ vibe 転送に
対応していません)。
パラメーター¶
名前 |
型 |
デフォルト |
備考 |
|---|---|---|---|
|
|
必須 |
base64 でエンコードされた参照 PNG/JPEG。 |
|
|
|
0.01–1.0。vibe が参照画像のアイデンティティをどれだけ強く取り込むか。 |
|
|
|
対象モデル ID (V4/V4.5 である必要があり、V5 は拒否されます)。 |
戻り値¶
str — base64 の vibe トークン。generate_image の references リストに渡します。
information_extracted の意味¶
値 |
効果 |
|---|---|
|
スタイル のみを取り込みます。生成画像は参照画像の絵画的表現、ライティング、配色を引き継ぎ、被写体は引き継ぎません。 |
|
バランス型。スタイル + おおよそのアイデンティティ (同じキャラクターの原型) を取り込みます。 |
|
アイデンティティ を取り込みます。生成画像は参照画像の被写体を忠実に再現します (例: 同じキャラクターを新しいポーズで)。 |
例¶
# Encode a reference style
vibe_token = await ctx.session.call_tool("encode_vibe", {
"reference": ref_b64,
"information_extracted": 0.3, # style only
})
# Use it in a generation
await ctx.session.call_tool("generate_image", {
"prompt": "1girl, watercolor style, peaceful meadow",
"references": [vibe_token],
})
複数の vibe¶
references はリストを受け付けるため、複数の vibe をブレンドできます:
style_vibe = await ctx.session.call_tool("encode_vibe", {
"reference": style_ref_b64,
"information_extracted": 0.2,
})
character_vibe = await ctx.session.call_tool("encode_vibe", {
"reference": character_ref_b64,
"information_extracted": 0.9,
})
await ctx.session.call_tool("generate_image", {
"prompt": "1girl, sitting in a cafe",
"references": [style_vibe, character_vibe],
})
キャッシュ¶
サーバーは vibe エンコード結果を (reference_hash, information_extracted, model) を
キーとしてメモリ上にキャッシュします。キャッシュサイズは NOVELAI_VIBE_CACHE_ENTRIES
(デフォルト 64) で上限が決まります。同じ参照画像を同じパラメーターで 2 回
エンコードするとキャッシュに当たり、API 呼び出しなしで即座に返ります。
ヒント¶
警告
V5 は vibe に対応していません。 V5 のモデル ID で encode_vibe を呼び出すと
ToolError が発生します。V3 / Furry モデルも対応範囲外です — novelai_image_mcp.nai
の supports_vibe() はそれらに対して False を返します — ただし拒否はローカルではなく
API によって強制されるため、エラーに頼らずエンコード前に述語で確認してください。
Tip
参照画像は数より品質が重要です。 高品質で適切にクロップされた 1 枚の参照画像 (クローズアップ、無地の背景) は、似た画像を大量に並べたノイズの多いセットよりも 良い vibe を生みます。
関連項目¶
vibe 転送のチュートリアル — encode → generate の一連のワークフロー