ピッカーカタログ
@nodaro/prompts を使って、Nodaro のピッカーを自分のアプリに実装します。選択をプロンプトの一節に変換し、ラベルを翻訳し、画像を表示します。API でカタログを読み取ることもできます。
ピッカーカタログは、ムード、レンズ、フレーミング、人物といった、Nodaro のピッカー(クリエイティブコントロールのノード)の 1 つを支えるデータです。ピッカーの選択肢、各選択肢が追加するプロンプトのテキスト、そのカテゴリー、翻訳のキーを保持します。カタログは npm パッケージの中に単純なデータとして同梱されているため、自分のアプリに、自分のスタイルで同じピッカーを実装し、Nodaro が組み立てるのとまったく同じプロンプトを組み立てられます。
ピッカーがモデルを呼び出すことはありません。ピッカーは、自分がつながっている先のノードのプロンプトに、説明的な一節を追加するだけです。クリエイティブコントロールを参照してください。
パッケージをインポートするか、API を呼び出す
| あなたのアプリ | 方法 |
|---|---|
| npm パッケージを同梱できる | @nodaro/prompts からカタログをインポートします。型が付いていて、オフラインで動作し、API 呼び出しは不要です。 |
| パッケージを同梱できない(MCP 経由の AI エージェントなど) | 同じデータを、ディスカバリー用のインターフェースから読み取ります。REST エンドポイントの GET /v1/picker-catalogs、SDK の client.pickerCatalogs、CLI の nodaro pickers、または MCP ツールの get_picker_catalog です。 |
できる場合は、パッケージを優先してください。リリースのときにしか変わらないデータのために、往復通信を省けます。
npm install @nodaro/prompts @nodaro/shared @nodaro/sdk@nodaro/prompts にはカタログとプロンプト用の関数が、@nodaro/shared には翻訳が入っており、@nodaro/sdk が生成を実行します。
レジストリ
import { PICKER_CATALOGS, getPickerCatalog, listPickerCatalogs } from "@nodaro/prompts/picker-catalogs"| エクスポート | 返す内容 |
|---|---|
PICKER_CATALOGS | すべてのピッカーカタログです。単一次元のピッカーが 28 個、複数次元のピッカーが 11 個あります。 |
getPickerCatalog(nodeTypeOrCatalogId) | ノードタイプ("mood" など)またはカタログ ID で指定する、1 つのカタログです。 |
listPickerCatalogs() | そのすべてです。 |
カタログの型は、次のとおりです。
interface PickerOption {
id: string
label: string // English display text; translate it with the catalogId (see below)
description?: string
category?: string // group id, matching categoryOrder and categoryLabels
promptHint: string // the clause this option adds ("" for a no-op option such as "auto")
term: string // the short professional term Compact mode adds ("" for a no-op option)
videoPromptHint?: string // Style only: the clause a video prompt adds instead of promptHint (in the package only; the API does not return it)
icon?: string // reserved; pictures are served separately (see "Pictures")
}
interface PickerDimension { // multi-dimension pickers, and the secondary fields of a single-dimension picker
field: string // for example "shotSize"
label: string
options: readonly PickerOption[]
}
interface PickerCatalog {
nodeType: string // "mood", "framing", ...
label: string
catalogId: string // the key of the translations
kind: "single" | "multi"
valueField?: string // single: the field a selection writes
defaultValue?: string
categoryOrder?: readonly string[]
categoryLabels?: Readonly<Record<string, string>>
options?: readonly PickerOption[] // single-dimension pickers
fields?: readonly string[] // multi-dimension pickers: the dimension fields
dimensions?: readonly PickerDimension[] // multi-dimension pickers, and secondary fields
}label は画面に表示し、term または promptHint はモデルに送ってください。一方からもう一方を導き出さないでください。
単一次元のピッカーを実装する
ムードのような単一次元のピッカーは、フラットなリストから 1 つを選ぶもので、グループ分けされることもあります。options には、グリッドを描画するために必要なものがすべて入っています。
import { getPickerCatalog, getParameterPromptHint } from "@nodaro/prompts/picker-catalogs"
import { createClient, StaticTokenAuth } from "@nodaro/sdk"
const client = createClient({
baseUrl: "https://app.nodaro.ai",
auth: new StaticTokenAuth(process.env.NODARO_ACCESS_TOKEN!),
})
const mood = getPickerCatalog("mood")! // { nodeType: "mood", valueField: "mood", options, categoryOrder, categoryLabels }
// 1. Render your own tile grid, grouped by category
function MoodPicker({ value, onChange }: { value?: string; onChange: (id: string) => void }) {
return (mood.categoryOrder ?? [undefined]).map((cat) => (
<section key={cat ?? "all"}>
{cat && <h4>{mood.categoryLabels?.[cat]}</h4>}
{mood.options!
.filter((o) => !cat || o.category === cat)
.map((o) => (
<button key={o.id} aria-pressed={value === o.id} title={o.description} onClick={() => onChange(o.id)}>
{o.label}
</button>
))}
</section>
))
}
// 2. Selection, then prompt clause, then generation
const selected = "serene"
const clause = getParameterPromptHint({ id: "mood-1", type: "mood", data: { mood: selected } })
// or: mood.options!.find((o) => o.id === selected)!.promptHint
const prompt = ["a portrait of a woman", clause].filter(Boolean).join(", ")
const result = await client.nodes.runAndWait("generate-image", { prompt })
console.log(result.imageUrl)トランジション、キャラクター FX、キャラクターモーションの副次パラメーター
3 つの単一次元のピッカーには、主要な選択のほかに、追加のフィールドがあります。トランジションとキャラクター FXには、それぞれ position、duration、intensity があります。キャラクターモーションには position と pace があります。
これらのフィールドもカタログであり、ほかのすべての選択肢と同じ行の形を持ち、各リストの先頭には、何もしない auto があります。カタログはこれらを、options に加えて、dimensions として公開します。メインのピッカーは options から、ドロップダウンは dimensions から描画してください。ID だけを送るクライアントが、タイミングの一節を自分で書くことはありません。
const fx = getPickerCatalog("character-fx")!
fx.options // the effects of the main picker
fx.dimensions // [{ field: "position", ... }, { field: "duration", ... }, { field: "intensity", ... }]
// Each dimension's rows are also exported directly:
// TRANSITION_POSITIONS / TRANSITION_DURATIONS / TRANSITION_INTENSITIES
// CHARACTER_FX_POSITIONS / CHARACTER_FX_DURATIONS / CHARACTER_FX_INTENSITIES
// CHARACTER_MOTION_POSITIONS / CHARACTER_MOTION_PACESトランジションとキャラクター FX は、同じ ID を共有します。start、middle、end、full。instant、short、medium、long。subtle、natural、dynamic、crazy です。ただし、文言までは共有しません。トランジションの文言は「起こる」「クリップ全体にわたる」、エフェクトの文言は「現れる」「持続する」のように書かれています。行は必ず、そのノード自身のカタログから読み取ってください。キャラクターモーションは position の ID を共有し、それに加えて、独自の pace の ID(slow-motion、slow、natural、fast、explosive)を、独自の文言とともに持ちます。
トランジションのカット用フラグ。 @nodaro/prompts のカタログ(getPickerCatalog("transition"))では、カットであるトランジションに instant: true が付きます。カットでは、duration と intensity は文を追加せず、position の full も何も追加しません。ブレンドできる 2 つのカット、seamless-match と jump-match には、さらに blendable: true が付きます。duration の次元の short の行には blendsCut: true が付きます。これは、ブレンドできるカットをブレンドカットに変える段階です。そのため、カットには full を除いた position を表示し、intensity は表示しないでください。ブレンドできるカットには、duration をブレンドとして表示します。ハードカットのままにする auto と、blendsCut の付いた行です。複数を選んだ場合、@nodaro/prompts が公開する isInstantTransition と isBlendableTransition は、選んだものすべてが該当するときにだけ true になります。これらのフラグは、パッケージのカタログにだけあります。GET /v1/picker-catalogs/transition、client.pickerCatalogs.get("transition")、MCP の get_picker_catalog ツールには含まれません。
複数次元のピッカーを実装する
複数次元のピッカーは、いくつかの独立したフィールドを同時に設定します。たとえばフレーミングは、ショットサイズ、アングル、カバレッジ、構図、撮影方向を設定します。そのカタログには、dimensions の中に、フィールドごとに 1 つの { field, label, options } エントリがあります。
import { getPickerCatalog, getParameterPromptHint } from "@nodaro/prompts/picker-catalogs"
const framing = getPickerCatalog("framing")!
// framing.dimensions = [
// { field: "shotSize", label: "Shot Size", options: [{ id: "close-up", ... }, ...] },
// { field: "angle", label: "Angle", options: [{ id: "low-angle", ... }, ...] },
// { field: "coverage", label: "Coverage", options: [...] },
// { field: "composition", label: "Composition", options: [...] },
// { field: "vantage", label: "Vantage", options: [...] },
// ]
function FramingPicker({ value, onChange }: {
value: Record<string, string>
onChange: (v: Record<string, string>) => void
}) {
return framing.dimensions!.map((dim) => (
<section key={dim.field}>
<h4>{dim.label}</h4>
{dim.options.map((o) => (
<button
key={o.id}
aria-pressed={value[dim.field] === o.id}
title={o.description}
onClick={() => onChange({ ...value, [dim.field]: o.id })}
>
{o.label}
</button>
))}
</section>
))
}
// Selection to clause: getParameterPromptHint composes every field that is set
const value = { shotSize: "close-up", angle: "low-angle", composition: "rule-of-thirds" }
const clause = getParameterPromptHint({ id: "framing-1", type: "framing", data: value })選択をプロンプトに変換する
getParameterPromptHint({ id, type, data }) は、単一次元でも複数次元でも、どの選択もその一節に変換します。Nodaro がサーバー上で実行しているのと同じ関数なので、あなたのプロンプトはエディターのものと一致します。カタログごとのビルダーもあります。複数次元のピッカー向けの buildFramingHints(value) や、1 つの選択肢向けの getMoodPromptHint(id) などです。
// Several pickers, one prompt, one generation
const clauses = [
getParameterPromptHint({ id: "mood-1", type: "mood", data: { mood: "serene" } }),
getParameterPromptHint({ id: "lens-1", type: "lens", data: { lens: "portrait-85mm" } }),
getParameterPromptHint({ id: "framing-1", type: "framing", data: { shotSize: "close-up", angle: "eye-level" } }),
]
const prompt = ["a portrait of a woman in a garden", ...clauses].filter(Boolean).join(", ")
const result = await client.nodes.runAndWait("generate-image", { prompt, provider: "nano-banana-2" })動画のプロンプトとスタイルの文言
どのスタイルにも 2 つの文言があります。静止画はその promptHint を読みます。動画のプロンプトは、動きのあるショットのために書かれた動画向けの文言 videoPromptHint を読みます。これはまず媒体を示し、次にその技法を示します。Nodaro の動画ノードと動画のルートは、動画向けの文言を追加します。それに合わせるには、一節を動画のプロンプトに入れるときに、3 番目の引数としてサーフェスを渡してください。すると、スタイルピッカーは動画向けの文言を返します。ほかのピッカーは、どちらのサーフェスでも同じ一節を返します。
import { getParameterPromptHint } from "@nodaro/prompts/picker-catalogs"
import { getStyleVideoPromptHint } from "@nodaro/prompts/pickers"
const style = { id: "style-1", type: "style", data: { style: "anime" } }
getParameterPromptHint(style) // still image: the option's promptHint
getParameterPromptHint(style, undefined, { surface: "video" }) // video: the style's video wording
getStyleVideoPromptHint("anime") // the same video wording, by id3 番目の引数を渡さない場合、または surface: "image" を渡した場合、この関数は画像向けの文言を返します。画像向けと動画向けのスタイルを参照してください。
ピッカーの data に hintMode: "compact" を追加すると、完全な一節の代わりに、短い term を取得できます。これは、エディターのプロンプトヒントトグルのコンパクトモードです。フルとコンパクトを参照してください。
| 関数 | 内容 |
|---|---|
getParameterPromptHint({ id, type, data }) | どの選択も、組み立てられた一節に変換します。動画のプロンプトでは、3 番目の引数として { surface: "video" } を渡してください。 |
getStyleVideoPromptHint(id) | 1 つのスタイルの動画向けの文言を返します。動画向けの文言がないスタイルは promptHint を返し、未知の ID は "" を返します。 |
build<Name>Hints(value) | buildFramingHints など、1 つのカタログの一節を組み立てます。 |
get<Name>PromptHint(id) | getMoodPromptHint など、1 つの選択肢の一節を返します。 |
PICKER_CATALOGS、getPickerCatalog、listPickerCatalogs | レジストリです。 |
ラベルを翻訳する
カタログのラベルは英語です。12 ロケール(en、es、fr、de、pt-BR、ru、hi、ja、ko、zh-CN、he、ar)の翻訳が、各カタログの catalogId をキーとして @nodaro/shared に同梱されています。promptHint と term の値は、モデルが読み取るため、英語のままです。
英語にはセットアップが不要です。それ以外のロケールでは、起動時に一度だけ翻訳バンドルを登録し、そのあとは同期的にラベルを取得します。フォールバックは英語です。
import { registerSidecarLoaders, ensureLocaleCatalogLoaded, resolveLabel } from "@nodaro/shared"
// 1. Once at startup, in a Vite app: wire the lazily loaded locale bundles
registerSidecarLoaders(import.meta.glob("/node_modules/@nodaro/shared/src/i18n/*.*.ts"))
// 2. Before rendering a locale, load that catalog's bundle
await ensureLocaleCatalogLoaded(mood.catalogId, "fr")
// 3. Resolve a label, synchronously; English when a translation is missing or not loaded yet
const label = resolveLabel(mood.catalogId, option.id, option.label, "fr")バンドルはオンデマンドで読み込まれるため、registerSidecarLoaders は、Vite の import.meta.glob が返すもののような、ローダーのマップを受け取ります。バックエンドとテストでは、翻訳を省略して、英語の label を使ってかまいません。
画像を表示する
自分のアプリでも、これらのピッカーについて、エディターと同じ画像を表示できます。
- 写真。人物、スタイリング、手に持つ小道具、素材、動物に表示されます。
- アート。音楽と音声のピッカー、音楽ジャンル、音楽のムード、楽器編成、声の特徴、話し方に表示されます。Nodaro Cloud では、この 5 つすべてが、3D の絵文字や国旗の代わりに、各選択肢の写真風のレンダリングを表示します。言語とアクセントのレンダリングには、その国旗が入っています。
- プレビュー静止画。見た目系のピッカーに表示されますが、Nodaro Cloud だけです。対象は、スタイル、カラー/ルック、年代/時代、レンズ、ムードです。ほかに、大気効果、構図エフェクト、カメラ/フィルム、フレーミング、ライティング、カメラモーションも含まれます。
API 経由の場合、画像がある選択肢には、問い合わせたインストール環境上の絶対 URL である imageUrl が付き、画像がない選択肢には何も付きません。唯一の例外は、後述する、デプロイメントが自身のサイトに置いた独自の画像です。REST のルート、つまり SDK でも、Nodaro CDN からのレンダリングには imageSrcSet も付きます。幅は 240〜1,920 px で、大きなタイルでも鮮明に表示されます。MCP ツールは imageSrcSet を返しません。人物とスタイリングは sections も返します。これは、各トピックを順番に並べたもので、それぞれに丸い画像が付きます。URL の規則は、後述の API でカタログを読み取るにあります。
デプロイメントは、画像をオフにできます。サーフェスプロファイルの catalogs.images で指定します。その場合、応答には imageUrl と imageSrcSet が含まれず、すべての imageCount が 0 になり、エディターにもこれらの画像は表示されません。エディションとサーフェスプロファイルを参照してください。
デプロイメントは、独自の画像を表示することもできます。catalogs.images: "own" で指定します。その場合、応答とエディターには、そのデプロイメントが登録した画像が表示されます。REST のルートでは、拡大画像を付けた選択肢に imageLargeUrl も含まれます。画像は、デプロイメントのメディアホスト上にあるか、デプロイメントが自身のサイトに置いたファイルです。自身のサイトに置いたファイルの場合、REST のルートは imageUrl と imageLargeUrl を、/brand/style/noir.webp のようなそのサイト上のパスとして返します。そのサイトが配信するページでは、パスをそのまま使います。それ以外のクライアントは、たとえば new URL(imageUrl, baseUrl) で、API を呼び出したアドレスを基準にパスを解決します。MCP ツールは、同じ画像を絶対 URL として返します。このようなパスを、リサイズやプロキシのアドレスに通さないでください。サイト自身のファイルです。
ライブラリの場合、@nodaro/prompts が、同じデータから同じ URL を組み立てます。
- 選択肢には
pickerOptionImageUrl(catalog, field, id, { baseUrl })、または{ url, srcSet? }を返すpickerOptionImage(...)。各幅を得るにはsrcSet: trueを渡します。 - 人物やスタイリングのトピックには
pickerSectionImageUrl(topicLabel, { baseUrl })。
baseUrl は、ファイルを配信する Nodaro のインストール環境です。画像は npm パッケージにではなく、インストール環境に属します。lookPreviews: true は、Nodaro Cloud に対してだけ渡してください。それ以外のピッカーについては、label、description、category から、自分で見た目を作成してください。
API でカタログを読み取る
どちらのエンドポイントも公開されていて、トークンは不要で、5 分間キャッシュされます。
| メソッド | パス | 返す内容 |
|---|---|---|
GET | /v1/picker-catalogs | すべてのピッカーの一覧です。nodeType、label、catalogId、kind、valueField または fields、optionCount、そして画像がある選択肢の数である imageCount(画像をオフにしたデプロイメントでは 0)が含まれます。 |
GET | /v1/picker-catalogs/:nodeType | 1 つのピッカーのカタログです。不明なタイプには 404 not_found が返ります。 |
GET /v1/picker-catalogs/:nodeType は、3 つのクエリパラメーターを受け取ります。不正な値には 400 validation_error が返ります。
| パラメーター | 値 | 動作 |
|---|---|---|
detail | compact(デフォルト)または full | compact は id、label、category、term、icon、imageUrl を返します。full は、各選択肢の description と promptHint を追加します。 |
category | カテゴリー ID | 単一次元のピッカーを、1 つのカテゴリーに絞り込みます。 |
field | フィールド名 | 複数次元のピッカーの 1 つの次元、またはトランジション、キャラクター FX、キャラクターモーションの副次フィールドの 1 つを返します。 |
style の選択肢では、promptHint は画像向けの文言です。動画のプロンプトはスタイルの動画向けの文言を追加しますが、これはどのカタログのエンドポイントも返しません。
画像向けと動画向けのスタイル。 1 種類の出力にだけ提供される style の選択肢は、どちらの詳細レベルでも media を持ちます。動画専用の 5 つのスタイル(felt-puppet、knitted-yarn、toy-figure-3d、painterly-3d、painted-clay)は ["video"] を持ちます。media のない選択肢は、画像と動画の両方に提供されます。画像のスタイル一覧からは、media に "image" を含まない選択肢が除かれます。それでも画像のルートに送られたスタイルは受け付けられ、画像にはその画像向けの文言が使われます。
クリップのスタイル変更向けのスタイル。 撮影された映像のスタイル変更にうまく機能しない style の選択肢は、どちらの詳細レベルでも restyle: false を持ちます。現在は fantasy、surrealism、concept-art です。クリップのスタイル変更向けのスタイル一覧からは、これらが除かれます。動画生成では引き続き提供され、これらを指定したスタイル変更も受け付けられます。
curl -s https://app.nodaro.ai/v1/picker-catalogs/mood | jq '.data.options[0]'{ "id": "happy", "label": "Happy", "category": "positive", "term": "happy expression",
"imageUrl": "https://cdn.nodaro.ai/cdn-cgi/image/width=480,format=auto,quality=80/picker-renders/710df65a-3c1e-485b-b8b7-29f7b3baf479.png",
"imageSrcSet": "https://cdn.nodaro.ai/cdn-cgi/image/width=240,format=auto,quality=80/picker-renders/710df65a-3c1e-485b-b8b7-29f7b3baf479.png 240w, https://cdn.nodaro.ai/cdn-cgi/image/width=480,format=auto,quality=80/picker-renders/710df65a-3c1e-485b-b8b7-29f7b3baf479.png 480w, https://cdn.nodaro.ai/cdn-cgi/image/width=960,format=auto,quality=80/picker-renders/710df65a-3c1e-485b-b8b7-29f7b3baf479.png 960w, https://cdn.nodaro.ai/cdn-cgi/image/width=1920,format=auto,quality=80/picker-renders/710df65a-3c1e-485b-b8b7-29f7b3baf479.png 1920w" }<img src="{imageUrl}" srcset="{imageSrcSet}" sizes="160px" alt="Happy">画像の URL
| ピッカー | 画像 |
|---|---|
person、styling、held-prop、material、animal | 写真です。WebP、幅は最大 480 px です。 |
music-genre、music-mood、instrumentation、voice-character、voice-delivery | Nodaro Cloud では、Nodaro CDN から配信される正方形の写真風のレンダリングです。480 px の静止画に加えて、元のサイズまでの imageSrcSet が付きます。言語やアクセントのレンダリングには、その国旗が入っています。セルフホスティング環境では、3D の絵文字画像(WebP、128 px)または国旗の画像(WebP、幅 120 px)です。 |
style、color-look、lens、framing、lighting、mood、camera-format、camera-motion などの見た目系のピッカー | Nodaro Cloud では、Nodaro CDN から配信される、レンダリング済みプレビューの 480 px の静止画で、imageSrcSet も付きます。camera-motion の場合はクリップの 1 フレームです。セルフホスティング環境では、何も返りません。 |
- ホスト。インストール環境は、自分の画像を
/picker-art/の下で配信するため、imageUrlはその公開アドレスを使います。Nodaro Cloud ではhttps://app.nodaro.ai、セルフホスティング環境ではPUBLIC_URLです。各 URL は、与えられたとおりに使ってください。選択肢の ID から自分で組み立てないでください。 - キャッシュ。ファイル名にはコンテンツのハッシュが含まれるため、画像が変わると URL も変わります。ファイルは
Cache-Control: public, max-age=31536000, immutableとAccess-Control-Allow-Origin: *付きで配信されるため、どのオリジンからでも、<img>、fetch、キャンバスで読み込めます。 - サイズ(
imageSrcSet)。REST のルートでは、Nodaro CDN からの画像にimageSrcSetも付きます。同じ画像の幅 240、480、960、1,920 px の版を、HTML のsrcsetの値にしたものです。CDN は画像を拡大しないので、最大の版でも元の画像のサイズを超えません。MCP ツールはimageSrcSetを返しません。タイルの幅を示すsizesと一緒に<img srcset>に渡してください。ブラウザーは、その画面で鮮明に表示される最小の版を取得します。imageUrlは 480 px の版です。セルフホスティング環境の画像はサイズが 1 つで、imageSrcSetはありません。 - トピック。
personとstylingはsectionsも返します。それぞれにlabel、まとめるfields、任意の丸いimageUrlが含まれます。 - 画像のないデプロイメント。画像をオフにしたデプロイメント(
catalogs.images)では、応答に画像はまったく含まれません。どの選択肢にもimageUrlやimageSrcSetはなく、どのトピックにもimageUrlはなく、一覧のすべてのピッカーのimageCountは0です。GET /v1/catalogsと MCP のget_picker_catalogツールでも同じです。それ以外は変わらないので、imageUrlのない選択肢にラベルを描くクライアントは、変更する必要がありません。
curl -s https://app.nodaro.ai/v1/picker-catalogs/person | jq '.data.sections[0], .data.dimensions[0].options[0]'{ "label": "Identity", "fields": ["type", "age", "ethnicity", "regionalAesthetic"],
"imageUrl": "https://app.nodaro.ai/picker-art/character/sections/identity.2d5ec1a4.webp" }
{ "id": "man", "label": "Man", "term": "man",
"imageUrl": "https://app.nodaro.ai/picker-art/character/person/man.d6bed999.webp" }デプロイメントのキュレーションされたカタログ
GET /v1/catalogs は、すべてのカタログを 1 回の呼び出しで、1 つのフラットな形として返します。デプロイメントは、選択肢を置き換え、追加、除外するベンダーパックを使って、自分のカタログをキュレーションでき、このエンドポイントはそのキュレーションを反映します。デプロイメントがパックを登録している場合、レスポンスには curated: true と、data にカタログが含まれます。登録していない場合は curated: false になり、同梱されているカタログは、ピッカーごとに /v1/picker-catalogs/:nodeType から読み取ります。SDK のメソッドは client.catalogs.list() です。
説明文からピッカーを埋める
POST /v1/text-to-picker は、シーンやショットの自由記述の説明文から、ピッカーの値を選びます。これは AI Fill(AI による自動入力)機能です。トークンが必要です。1 回の実行では、ピッカーのファミリーごとに LLM を 1 回呼び出し、まとめて 1 回課金されます。課金は、呼び出しで実際に使ったトークンに応じて、各呼び出しを処理したレーンでの、選んだモデルの単価で行われます。説明をピッカーへと同じルールです。デフォルトの実行はすべてのピッカーのカタログを読むため、画像の読み取り 1 回の数倍のテキストを使います。
- 実行の前に、確保額が確保されます。これは、各呼び出しのモデルの出力上限での 1 回目の試行の分です。残高が確保額より少ない場合は、
402(「最大 N クレジットが必要です。」)で拒否されます。 - 見積もり:キー
text-to-picker:<model>(プロバイダー自身の API では:directを付ける)を指定したPOST /v1/credits/model-costsが、一般的な実行の見積もりを返します。estimatesに一覧表示されるので、≈Nと表示してください。llmModelを指定しない場合、実行はアグリゲーター上の Gemini 3.8 Flash を使います。強度を指定しない Claude Opus 5.5 は、Anthropic 自身の API 上でhighで実行されるので、そのキーはtext-to-picker:claude-opus-5.5:directです。 - 失敗:プロバイダーが課金した呼び出しは、失敗したものも含めてすべて請求されます。プロバイダーが呼び出しに課金しなかった実行は返還されます。
Claude Fable 5 は、このルートで提供されています。LLM 呼び出しの課金のしくみを参照してください。このルートから返されるのは、ピッカーのタイプ、次元、選ばれた ID の順にキーが付いた pickerJson と、どのカタログの選択肢にも当てはまらなかった説明内容である gaps です。SDK のメソッドは client.pickerCatalogs.analyzeText()、CLI のコマンドは nodaro pickers analyze です。
キャラクターモーションのメタデータ
キャラクターモーションのカタログの選択肢は、両方の詳細レベルで motion メタデータを持つことがあります。このメタデータは、動きを次のように説明します。
- 必要条件、開始と終了のポーズ、そして動作後の可視性と手の状態です。
- 手が空いている必要があるか、その種類、固定のペース、対になる動きです。
- 検索用の別名、そして ID が廃止されているかどうかと、その代わりとなる ID です。
フィールドがない場合は、不明を意味します。
保存されたワークフローを読み込むときは、廃止された ID も動作するようにし、新しい選択肢には表示しないでください。この型は CharacterMotionMetadata で、@nodaro/prompts からエクスポートされています。
よくある質問
ピッカーカタログを使うのに、Nodaro API は必要ですか?
必要ありません。カタログと、選択をプロンプトの一節に変換する関数は、@nodaro/prompts という npm パッケージに同梱されているため、自分のアプリはオフラインでピッカーを描画し、プロンプトを組み立てられます。API のエンドポイントは、パッケージを同梱できないクライアントのために存在します。
ピッカーの選択を、プロンプトのテキストに変換するには、どうすればよいですか?
ピッカーのノードタイプと、選んだムードの ID などのデータを指定して、getParameterPromptHint を呼び出します。Nodaro もサーバー上で同じ関数を実行しているため、あなたのプロンプトは、エディターが組み立てるものと一致します。
ピッカーのラベルは、どの言語に対応していますか?
12 のロケールです。英語、スペイン語、フランス語、ドイツ語、ブラジルポルトガル語、ロシア語、ヒンディー語、日本語、韓国語、簡体字中国語、ヘブライ語、アラビア語です。プロンプトのテキストと用語は、モデルが読み取るため、英語のままです。
セルフホスティング環境では、見た目系のピッカーに画像がないのはなぜですか?
ムードやライティングなど、見た目系のピッカーのプレビューは Nodaro CDN から配信されており、返すのは Nodaro Cloud だけです。人物、スタイリング、手に持つ小道具、素材、動物の写真と、音楽・音声のアートは、どのインストール環境でも配信されます。
ピッカーカタログはいくつありますか?
39 個です。ムードやレンズなどの単一次元のピッカーが 28 個、フレーミング、ライティング、人物などの複数次元のピッカーが 11 個あります。
関連ページ
クリエイティブコントロール
ムード
TypeScript SDK
MCP ツールリファレンス
コマンド
最終更新