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 app | Use |
|---|---|
| Consegue incluir um pacote npm no próprio código | Importe 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 MCP | Leia 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ção | O que retorna |
|---|---|
PICKER_CATALOGS | Todos 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_PACESTransiçã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 idSem 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ção | O 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, listPickerCatalogs | O 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, oupickerOptionImage(...)para{ url, srcSet? }. PassesrcSet: truepara 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étodo | Caminho | O que retorna |
|---|---|---|
GET | /v1/picker-catalogs | Um 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/:nodeType | O 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âmetro | Valores | O que faz |
|---|---|---|
detail | compact (padrão) ou full | compact retorna id, label, category, term, icon e imageUrl. full adiciona a description e o promptHint de cada opção. |
category | Um id de categoria | Filtra um seletor de uma dimensão por uma categoria. |
field | Um nome de campo | Retorna 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
| Seletores | Imagem |
|---|---|
person, styling, held-prop, material, animal | Uma foto, WebP, com até 480 px de largura. |
music-genre, music-mood, instrumentation, voice-character, voice-delivery | No 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-motion | No 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 oimageUrlusa o endereço público dela:https://app.nodaro.aino Nodaro Cloud, ou oPUBLIC_URLde 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, immutableeAccess-Control-Allow-Origin: *, então qualquer origem pode carregá-los em um<img>, comfetchou em um canvas. - Tamanhos (
imageSrcSet). Nas rotas REST, uma imagem da CDN do Nodaro também trazimageSrcSet: a mesma imagem com 240, 480, 960 e 1.920 px de largura, como um valorsrcsetde HTML. A CDN nunca amplia uma imagem, então a maior cópia tem no máximo o tamanho da origem. As ferramentas MCP omitemimageSrcSet. Passe-o para<img srcset>com umsizesque 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 nenhumimageSrcSet. - Tópicos.
personestylingtambém retornamsections, cada uma com umlabel, osfieldsque ela agrupa e umimageUrlredondo 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 temimageUrlouimageSrcSet, nenhum tópico temimageUrl, e todo seletor do diretório tem umimageCountde0. O mesmo vale paraGET /v1/catalogse para a ferramenta MCPget_picker_catalog. Todo o resto continua igual, então um cliente que desenha um rótulo para uma opção semimageUrlnã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-costscom a chavetext-to-picker:<model>, mais:directna própria API do provedor, retorna uma estimativa de uma execução típica. Ela aparece emestimates, então mostre-a como≈N. SemllmModel, a execução usa o Gemini 3.8 Flash no agregador. O Claude Opus 5.5 sem esforço roda emhighna 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.
Páginas relacionadas
Controles criativos
Clima
SDK para TypeScript
Referência das ferramentas MCP
Comandos
Última atualização
Login externo (SSO)
Use um provedor de identidade confiável no login de uma instalação do Nodaro, com asserção JWT assinada, OIDC ou SAML, e controle a vinculação de contas.
Incorporações
As duas formas de levar o Nodaro ao seu produto: um miniapp que executa um workflow publicado e o viewport de cena 3D sem estado, e quando usar cada uma.