NodaroAccount
Nodaro ドキュメント
ドキュメントノードリファレンスモデルテンプレートAI エージェント(MCP)開発者向けセルフホスティングリサーチ比較

ピッカーカタログ

@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 id

3 番目の引数を渡さない場合、または 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/:nodeType1 つのピッカーのカタログです。不明なタイプには 404 not_found が返ります。

GET /v1/picker-catalogs/:nodeType は、3 つのクエリパラメーターを受け取ります。不正な値には 400 validation_error が返ります。

パラメーター値動作
detailcompact(デフォルト)または fullcompact は 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-deliveryNodaro 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 個あります。

最終更新

目次