NodaroAccount
Docs do Nodaro
DocumentaçãoReferência de nósModelosTemplatesAgentes de IA (MCP)DesenvolvedoresAuto-hospedagemPesquisaComparações

Catálogos de seletores

Crie seletores do Nodaro em seu app com @nodaro/prompts, converta seleções em trechos de prompt, traduza rótulos, mostre imagens ou leia catálogos via API.

Um catálogo de seletor é o conjunto de dados por trás de um dos seletores do Nodaro, os nós dos Controles criativos, como Clima, Lente, Enquadramento e Pessoa. Ele contém as opções do seletor, o texto de prompt que cada opção adiciona, as categorias e as chaves das traduções. Os catálogos vêm como dados simples em pacotes npm, então você pode criar os mesmos seletores no seu próprio app, com o seu próprio estilo, e montar exatamente os prompts que o Nodaro monta.

Um seletor nunca chama um modelo. Ele adiciona um trecho descritivo ao prompt do nó que ele alimenta; veja Controles criativos.

Importar o pacote ou chamar a API

O seu appUse
Consegue incluir um pacote npm no próprio códigoImporte os catálogos de @nodaro/prompts. Eles são tipados, funcionam offline e não precisam de chamada à API.
Não consegue incluir um pacote, como um agente de IA via MCPLeia os mesmos dados pela interface de descoberta: o endpoint REST GET /v1/picker-catalogs, client.pickerCatalogs no SDK, nodaro pickers na CLI ou a ferramenta MCP get_picker_catalog.

Prefira o pacote quando puder: ele evita uma ida e volta à rede por dados que só mudam a cada versão.

npm install @nodaro/prompts @nodaro/shared @nodaro/sdk

@nodaro/prompts contém os catálogos e as funções de prompt, @nodaro/shared contém as traduções, e @nodaro/sdk executa a geração.

O registro

import { PICKER_CATALOGS, getPickerCatalog, listPickerCatalogs } from "@nodaro/prompts/picker-catalogs"
ExportaçãoO que retorna
PICKER_CATALOGSTodos os catálogos de seletores: 28 seletores de uma dimensão e 11 de várias dimensões.
getPickerCatalog(nodeTypeOrCatalogId)Um catálogo, pelo tipo de nó (como "mood") ou pelo id do catálogo.
listPickerCatalogs()Todos eles.

Os tipos do catálogo:

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
}

Mostre o label e envie term ou promptHint ao modelo. Nunca derive um do outro.

Criar um seletor de uma dimensão

Um seletor de uma dimensão, como o Clima, é uma escolha em uma lista simples, opcionalmente agrupada. options traz tudo o que você precisa para desenhar a grade.

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)

Parâmetros secundários de Transição, Efeitos de personagem e Movimento de personagem

Três seletores de uma dimensão têm campos extras além da escolha principal. Transição e Efeitos de personagem têm, cada um, position, duration e intensity. Movimento de personagem tem position e pace.

Esses campos também são catálogos, com as mesmas linhas de qualquer outra opção, e cada lista começa com um auto sem efeito. O catálogo os expõe como dimensions, além de options. Desenhe o seletor principal a partir de options e os menus suspensos a partir de dimensions; um cliente que envia só ids nunca escreve ele mesmo o trecho de timing.

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

Transição e Efeitos de personagem compartilham os mesmos ids: start, middle, end e full; instant, short, medium e long; subtle, natural, dynamic e crazy. Eles não compartilham o texto: uma transição acontece e se estende pelo clipe, enquanto um efeito aparece e persiste. Sempre leia as linhas do catálogo do próprio nó. Movimento de personagem compartilha os ids de posição e adiciona os próprios ids de ritmo, slow-motion, slow, natural, fast e explosive, com o próprio texto.

Os marcadores de corte da Transição. No catálogo de @nodaro/prompts (getPickerCatalog("transition")), uma transição que é um corte traz instant: true. Em um corte, duration e intensity não acrescentam nenhuma frase, e a position full não acrescenta nada. Os dois cortes que podem ser mesclados, seamless-match e jump-match, também trazem blendable: true. A linha short da dimensão duration traz blendsCut: true: é a etapa que transforma um corte mesclável em um corte com mesclagem. Por isso, ofereça a um corte a position sem full, e nenhuma intensity. Ofereça a um corte mesclável a duration como mesclagem: auto, que mantém o corte seco, mais as linhas com blendsCut. Para várias escolhas, isInstantTransition e isBlendableTransition, ambas exportadas por @nodaro/prompts, são verdadeiras só quando todas as escolhas são. Os marcadores existem só no catálogo do pacote. GET /v1/picker-catalogs/transition, client.pickerCatalogs.get("transition") e a ferramenta get_picker_catalog do MCP não os trazem.

Criar um seletor de várias dimensões

Um seletor de várias dimensões define vários campos independentes de uma vez. O Enquadramento, por exemplo, define o tamanho do plano, o ângulo, a cobertura, a composição e o ponto de vista. O catálogo dele tem uma entrada { field, label, options } por campo em dimensions.

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 })

Transformar seleções em prompt

getParameterPromptHint({ id, type, data }) transforma qualquer seleção, de uma ou de várias dimensões, no trecho correspondente. É a mesma função que o Nodaro executa nos servidores dele, então os seus prompts correspondem aos do editor. Também existem construtores por catálogo, como buildFramingHints(value) para um seletor de várias dimensões e getMoodPromptHint(id) para uma opção.

// 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" })

Prompts de vídeo e o texto do Estilo

Todo estilo tem dois textos. Imagens fixas leem o promptHint dele. Prompts de vídeo leem um texto de vídeo, videoPromptHint, escrito para tomadas em movimento: ele cita primeiro o meio, depois as técnicas dele. Os nós de vídeo e as rotas de vídeo do Nodaro adicionam o texto de vídeo. Para corresponder a eles, passe a superfície como terceiro argumento quando o trecho for para um prompt de vídeo. O seletor Estilo retorna então o texto de vídeo dele. Todos os outros seletores retornam o mesmo trecho para as duas superfícies.

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

Sem um terceiro argumento, ou com surface: "image", a função retorna o texto de imagem. Veja Estilos para imagens e para vídeo.

Adicione hintMode: "compact" ao data de um seletor para obter o term curto dele em vez do trecho completo. Esse é o modo Compacto da opção Trecho do prompt do editor; veja Completo ou Compacto.

FunçãoO que faz
getParameterPromptHint({ id, type, data })Transforma qualquer seleção no trecho composto correspondente. Passe { surface: "video" } como terceiro argumento para um prompt de vídeo.
getStyleVideoPromptHint(id)Devolve o texto de vídeo de um estilo. Um estilo sem texto de vídeo devolve o promptHint dele, e um id desconhecido devolve "".
build<Name>Hints(value)Monta o trecho de um catálogo, como buildFramingHints.
get<Name>PromptHint(id)Devolve o trecho de uma opção, como getMoodPromptHint.
PICKER_CATALOGS, getPickerCatalog, listPickerCatalogsO registro.

Traduzir os rótulos

Os rótulos dos catálogos estão em inglês. As traduções para 12 idiomas vêm em @nodaro/shared, indexadas pelo catalogId de cada catálogo: en, es, fr, de, pt-BR, ru, hi, ja, ko, zh-CN, he e ar. Os valores de promptHint e term ficam em inglês, porque são os modelos que os leem.

O inglês não precisa de configuração. Para os outros idiomas, registre os bundles de tradução uma vez na inicialização e depois resolva os rótulos de forma síncrona, com o inglês como fallback:

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")

Os bundles são carregados sob demanda, então registerSidecarLoaders recebe um mapa de carregadores, como o que o import.meta.glob do Vite devolve. Backends e testes podem pular a tradução e usar o label em inglês.

Mostrar imagens

O seu app pode mostrar as mesmas imagens que o editor mostra nestes seletores:

  • Fotos em Pessoa, Figurino e beleza, Objeto na mão, Material e Animal.
  • Arte nos seletores de música e de voz: Gênero musical, Clima musical, Instrumentação, Perfil da voz e Estilo de fala. No Nodaro Cloud, os cinco mostram uma renderização fotográfica de cada opção no lugar dos emojis 3D e das bandeiras. As renderizações de idioma e de sotaque trazem as bandeiras deles.
  • Imagens de prévia nos seletores de look, só no Nodaro Cloud. São eles: Estilo, Cor / look, Época / período, Lente, Clima, Atmosfera, Efeito de composição, Câmera / película, Enquadramento, Iluminação e Movimento de câmera.

Pela API, toda opção com imagem traz um imageUrl absoluto na instalação consultada, e uma opção sem imagem não traz nenhum. A única exceção é uma imagem própria da implantação guardada no site dela, descrita abaixo. Nas rotas REST, e portanto no SDK, uma renderização da CDN do Nodaro também traz imageSrcSet, de 240 a 1.920 px de largura, para que um bloco grande continue nítido. A ferramenta MCP o omite. Pessoa e Figurino e beleza também retornam sections: os tópicos deles, em ordem, cada um com uma imagem redonda. As regras das URLs estão em Ler os catálogos pela API.

Uma implantação pode desativar as imagens com catalogs.images no perfil de superfície. As respostas dela então não trazem imageUrl nem imageSrcSet, todo imageCount é 0, e o editor dela não mostra nenhuma dessas imagens. Veja Edições e perfis de superfície.

Uma implantação também pode mostrar imagens próprias com catalogs.images: "own". As respostas e o editor dela então mostram as imagens que ela registrou. Nas rotas REST, uma opção à qual ela deu uma imagem ampliada também traz imageLargeUrl. As imagens ficam no host de mídia da implantação, ou são arquivos que ela publica no próprio site. Para um arquivo que ela publica no próprio site, as rotas REST informam imageUrl e imageLargeUrl como um caminho nesse site, como /brand/style/noir.webp. Uma página que o site serve usa o caminho como veio. Qualquer outro cliente o resolve a partir do endereço em que chamou a API, por exemplo com new URL(imageUrl, baseUrl). A ferramenta MCP informa a mesma imagem como uma URL absoluta. Nunca passe esse caminho por um endereço de redimensionamento ou de proxy: ele é um arquivo do próprio site.

Na biblioteca, @nodaro/prompts monta as mesmas URLs a partir dos mesmos dados:

  • pickerOptionImageUrl(catalog, field, id, { baseUrl }) para uma opção, ou pickerOptionImage(...) para { url, srcSet? }. Passe srcSet: true para as larguras;
  • pickerSectionImageUrl(topicLabel, { baseUrl }) para um tópico de Pessoa ou de Figurino e beleza.

baseUrl é a instalação do Nodaro que serve os arquivos: as imagens pertencem à instalação, não ao pacote npm. Passe lookPreviews: true só com o Nodaro Cloud. Para todos os outros seletores, desenhe os seus próprios visuais a partir de label, description e category.

Ler os catálogos pela API

Os dois endpoints são públicos, não precisam de token e ficam em cache por 5 minutos.

MétodoCaminhoO que retorna
GET/v1/picker-catalogsUm diretório de todos os seletores: nodeType, label, catalogId, kind, valueField ou fields, optionCount e imageCount, o número de opções com imagem (0 em uma implantação que desativou as imagens).
GET/v1/picker-catalogs/:nodeTypeO catálogo de um seletor. Um tipo desconhecido responde 404 not_found.

GET /v1/picker-catalogs/:nodeType aceita três parâmetros de query. Um valor inválido responde 400 validation_error.

ParâmetroValoresO que faz
detailcompact (padrão) ou fullcompact retorna id, label, category, term, icon e imageUrl. full adiciona a description e o promptHint de cada opção.
categoryUm id de categoriaFiltra um seletor de uma dimensão por uma categoria.
fieldUm nome de campoRetorna uma dimensão de um seletor de várias dimensões, ou um campo secundário de Transição, Efeitos de personagem ou Movimento de personagem.

Para uma opção de style, promptHint é o texto de imagem. Um prompt de vídeo adiciona o texto de vídeo do estilo, que nenhum endpoint de catálogo retorna.

Estilos de imagem e de vídeo. Uma opção de style oferecida para um só tipo de saída traz media, nos dois níveis de detalhe. Os cinco estilos só de vídeo (felt-puppet, knitted-yarn, toy-figure-3d, painterly-3d e painted-clay) trazem ["video"]. Uma opção sem media é oferecida para imagens e vídeo. Uma lista de estilos de imagem deixa de fora uma opção cujo media não tem "image". Um estilo enviado mesmo assim a uma rota de imagem continua sendo aceito, e a imagem recebe o texto de imagem dele.

Estilos para reestilizar um clipe. Uma opção de style que não funciona bem como reestilização de uma filmagem traz restyle: false, nos dois níveis de detalhe: hoje fantasy, surrealism e concept-art. Uma lista de estilos para reestilizar um clipe a deixa de fora. A geração de vídeo continua oferecendo essa opção, e uma reestilização que a cita continua sendo aceita.

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">

As URLs das imagens

SeletoresImagem
person, styling, held-prop, material, animalUma foto, WebP, com até 480 px de largura.
music-genre, music-mood, instrumentation, voice-character, voice-deliveryNo Nodaro Cloud, uma renderização fotográfica quadrada da CDN do Nodaro: uma imagem fixa de 480 px, mais imageSrcSet até o tamanho completo dela. Uma renderização de idioma ou de sotaque traz a sua bandeira. Em uma instalação auto-hospedada, uma imagem de emoji 3D (WebP, 128 px) ou uma bandeira (WebP, 120 px de largura).
Seletores de look, como style, color-look, lens, framing, lighting, mood, camera-format e camera-motionNo Nodaro Cloud, uma imagem fixa de 480 px da prévia renderizada, vinda da CDN do Nodaro, mais imageSrcSet; para camera-motion, um quadro do clipe. Uma instalação auto-hospedada não retorna nenhuma.
  • Host. Uma instalação serve as próprias imagens em /picker-art/, então o imageUrl usa o endereço público dela: https://app.nodaro.ai no Nodaro Cloud, ou o PUBLIC_URL de uma instalação auto-hospedada. Use cada URL como ela vem; nunca monte uma a partir do id de uma opção.
  • Cache. Os nomes dos arquivos trazem um hash do conteúdo, então uma imagem alterada ganha uma URL nova. Os arquivos são servidos com Cache-Control: public, max-age=31536000, immutable e Access-Control-Allow-Origin: *, então qualquer origem pode carregá-los em um <img>, com fetch ou em um canvas.
  • Tamanhos (imageSrcSet). Nas rotas REST, uma imagem da CDN do Nodaro também traz imageSrcSet: a mesma imagem com 240, 480, 960 e 1.920 px de largura, como um valor srcset de HTML. A CDN nunca amplia uma imagem, então a maior cópia tem no máximo o tamanho da origem. As ferramentas MCP omitem imageSrcSet. Passe-o para <img srcset> com um sizes que diga a largura do bloco. O navegador então baixa a menor cópia que continua nítida naquela tela. imageUrl é a cópia de 480 px. As imagens auto-hospedadas têm um só tamanho e nenhum imageSrcSet.
  • Tópicos. person e styling também retornam sections, cada uma com um label, os fields que ela agrupa e um imageUrl redondo opcional.
  • Uma implantação sem imagens. Em uma implantação que desativou as imagens (catalogs.images), as respostas não trazem nenhuma imagem. Nenhuma opção tem imageUrl ou imageSrcSet, nenhum tópico tem imageUrl, e todo seletor do diretório tem um imageCount de 0. O mesmo vale para GET /v1/catalogs e para a ferramenta MCP get_picker_catalog. Todo o resto continua igual, então um cliente que desenha um rótulo para uma opção sem imageUrl não precisa mudar nada.
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" }

Os catálogos curados de uma implantação

GET /v1/catalogs retorna todos os catálogos em uma única chamada, em um formato plano único. Uma implantação pode fazer a curadoria dos catálogos com pacotes vendorizados que substituem, estendem ou bloqueiam opções, e esse endpoint reflete essa curadoria. Quando a implantação registrou pacotes, a resposta traz curated: true e os catálogos em data. Sem nenhum pacote, ela traz curated: false, e você lê os catálogos incluídos, seletor por seletor, em /v1/picker-catalogs/:nodeType. O método do SDK é client.catalogs.list().

Preencher seletores a partir de uma descrição

POST /v1/text-to-picker escolhe valores de seletores a partir de uma descrição em texto livre de uma cena ou de uma tomada. Esse é o recurso AI Fill. Ele exige um token. Uma execução faz uma chamada de LLM por família de seletores e é cobrada uma vez. A cobrança é pelos tokens que as chamadas realmente usaram, pela tarifa do modelo selecionado na via que atendeu cada chamada, a mesma regra do Descrever para seletor. Uma execução padrão lê o catálogo de todos os seletores, então usa várias vezes o texto de uma leitura de imagem.

  • Antes da execução, uma reserva é feita: a primeira tentativa de cada chamada no limite de saída do modelo. Um saldo abaixo da reserva é recusado com 402 (“São necessários até N créditos”).
  • A cotação: POST /v1/credits/model-costs com a chave text-to-picker:<model>, mais :direct na própria API do provedor, retorna uma estimativa de uma execução típica. Ela aparece em estimates, então mostre-a como ≈N. Sem llmModel, a execução usa o Gemini 3.8 Flash no agregador. O Claude Opus 5.5 sem esforço roda em high na API da própria Anthropic, então a chave dele é text-to-picker:claude-opus-5.5:direct.
  • Falhas: toda chamada que o provedor cobrou é cobrada, inclusive uma que falhou. Uma execução cujas chamadas o provedor não cobrou é reembolsada.

O Claude Fable 5 é oferecido nesta rota. Veja Como as chamadas de LLM são cobradas. A rota retorna pickerJson, organizado por tipo de seletor, depois por dimensão e depois pelos ids escolhidos, e gaps, os detalhes descritos que nenhuma opção de catálogo representa. O método do SDK é client.pickerCatalogs.analyzeText(), e o comando da CLI é nodaro pickers analyze.

Metadados de Movimento de personagem

As opções do catálogo de Movimento de personagem podem trazer metadados motion, nos dois níveis de detalhe. Os metadados descrevem o movimento:

  • Os requisitos, as poses inicial e final, e a visibilidade e as mãos depois do movimento.
  • Se ele precisa das mãos livres, o tipo, um ritmo fixo e a contraparte.
  • Apelidos de busca, e se o id foi descontinuado e qual id o substitui.

Um campo ausente significa desconhecido.

Mantenha os ids descontinuados funcionando ao carregar workflows salvos, e oculte-os das novas escolhas. O tipo é CharacterMotionMetadata, exportado por @nodaro/prompts.

Perguntas frequentes

Preciso da API do Nodaro para usar os catálogos de seletores?

Não. Os catálogos, e a função que transforma uma seleção em um trecho de prompt, vêm no pacote npm @nodaro/prompts, então o seu app pode mostrar os seletores e montar prompts offline. Os endpoints da API existem para clientes que não conseguem incluir o pacote.

Como transformo a seleção de um seletor em texto de prompt?

Chame getParameterPromptHint com o tipo de nó do seletor e os dados dele, como o id do clima escolhido. O Nodaro executa a mesma função nos servidores dele, então o seu prompt corresponde ao que o editor monta.

Quais idiomas os rótulos dos seletores aceitam?

12 idiomas: inglês, espanhol, francês, alemão, português do Brasil, russo, hindi, japonês, coreano, chinês simplificado, hebraico e árabe. O texto do prompt e os termos ficam em inglês, porque são os modelos que os leem.

Por que os seletores de look não têm imagens na minha instalação auto-hospedada?

As prévias dos seletores de look, como Clima e Iluminação, vêm da CDN do Nodaro, e só o Nodaro Cloud as retorna. Toda instalação serve as fotos de Pessoa, Figurino e beleza, Objeto na mão, Material e Animal, e a arte de música e de voz.

Quantos catálogos de seletores existem?

39. São 28 seletores de uma dimensão, como Clima e Lente, e 11 seletores de várias dimensões, como Enquadramento, Iluminação e Pessoa.

Última atualização

Nesta página