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

Executar nós

Execute qualquer nó do Nodaro em TypeScript, sem workflow: descubra os tipos, inicie execuções, aguarde resultados e passe referências e direção de câmera.

client.nodes lista os tipos de nó que um servidor do Nodaro aceita e executa qualquer um deles diretamente, sem montar um workflow. Uma execução envia os seus parâmetros para a rota própria do nó, POST /v1/<type> para a maioria dos tipos de nó, e retorna uma tarefa que você pode aguardar. É o mesmo caminho que a CLI usa em nodaro nodes run e que as ferramentas MCP do Nodaro usam. Veja Executar um único nó para a visão REST.

Métodos

MétodoO que faz
nodes.list()Lista todos os tipos de nó, com os modelos e o custo em créditos de cada um
nodes.get(type)Lê um tipo de nó
nodes.run(type, params?, options?)Inicia um nó e retorna o ID da tarefa imediatamente
nodes.quote(type, params?)Calcula o preço de uma execução antes de você iniciá-la
nodes.runAndWait(type, params?, opts?)Inicia um nó, consulta a tarefa periodicamente e retorna a saída
nodes.runMany(type, paramsList, opts?)Inicia várias execuções de um nó ao mesmo tempo e aguarda todas
nodes.runBatchAndWait(type, params, opts?)Cria várias imagens em uma chamada do Gerar imagem e aguarda cada uma

client.nodes

list()

Lista todos os tipos de nó que o servidor aceita. O servidor pode manter a resposta em cache por 5 minutos. A chamada não custa nada e não exige escopos.

list(): Promise<{ data: NodeDescriptor[] }>
const { data: nodes } = await client.nodes.list()

const imageGenerators = nodes.filter((n) => n.category === "ai-image")
const takesReferences = nodes.filter((n) => n.capabilities?.includes("supports-reference-image"))

Cada NodeDescriptor tem estes campos:

CampoTipoDescrição
typestringO tipo na API, como generate-image. Passe-o para run().
labelstringO nome do nó no editor.
categorystringA categoria, como ai-image, ai-video, ai-audio, ai-text, processing ou parameter.
descriptionstringUma descrição de uma linha.
outputTypestringtext, image, video, audio, data ou none.
creditCostnumber | stringO custo em créditos cobrado por uma execução, o mesmo número do botão Executar do nó: um número quando é fixo, ou uma faixa como "3-682" quando depende do modelo. No Cortar vídeo, no Vídeo em loop e no Combinar vídeos, ele é, em vez disso, o preço de um bloco de 5 segundos, e uma execução custa um certo número de blocos. Só no Nodaro Cloud.
estimatebooleantrue quando creditCost é uma estimativa: a chamada típica de um nó de LLM medido com o modelo padrão dele. Mostre-o como ≈N. Um nó de LLM medido cujo modelo padrão ainda não tem preço lista creditCost: "unpriced".
creditRateNodeCreditRatePara um nó cobrado por unidade da própria medida, como o Quadros dos falantes (creditCost "per-1000-frames"): { identifier, unit, creditsPerUnit, minUnits, rounding, note }. Uma execução de N unidades é cobrada Math.ceil(Math.max(minUnits, N) * creditsPerUnit), arredondado uma vez.
providersstring[]Os IDs dos modelos que o nó pode executar, para o parâmetro provider.
capabilitiesstring[]Flags como supports-reference-image ou supports-end-frame.
inputSchema{ fields }Os campos de entrada que você pode definir, cada um com key, type, required e options.
maxDurationSecnumberA maior duração que o nó aceita, quando ele tem um limite.
providerResolutionsRecord<string, string[]>As resoluções que cada modelo aceita, quando elas variam.

As instalações auto-hospedadas Community e Business não têm sistema de créditos, então os descritores delas omitem creditCost.

get(type)

Lê o descritor de um tipo de nó.

get(type: string): Promise<{ data: NodeDescriptor }>

Propriedade

Tipo

const { data: node } = await client.nodes.get("generate-video")
console.log(node.providers)  // every video model id
console.log(node.creditCost) // Nodaro Cloud only

Para mostrar os preços ao lado dos modelos, passe node.providers para client.credits.modelCosts().

run(type, params?, options?)

Inicia um nó e retorna imediatamente. O corpo é enviado para a rota do nó, POST /v1/<type> para a maioria dos tipos de nó. Os nomes dos campos correspondem aos campos de entrada do nó.

run(type: string, params?: Record<string, unknown>, options?: { idempotencyKey?: string }): Promise<RunNodeResult>

Propriedade

Tipo

const result = await client.nodes.run("generate-image", {
  prompt: "A snow leopard in the mountains",
  provider: "nano-banana-2",
})

if ("jobId" in result) {
  const { data: job } = await client.jobs.getStatus(result.jobId)
  console.log(job.status)
}

Tipos de nó com uma rota própria. Alguns tipos de nó são executados em outra rota, e run() envia para ela por você:

Tipos de nóRota
generate-3d-scene, edit-3d-scene/v1/3d-scene/generate, /v1/3d-scene/edit
llm-chat, after-effects, motion-graphics, lottie-overlay, 3d-title/v1/<type>/generate
image-to-text/v1/image-to-text/describe
video-composer/v1/scene-graph/generate
telegram-channel-feed/v1/telegram-channel/fetch
Todos os nós suno-* menos o Fala com Suno, como suno-generate e suno-cover/v1/suno/<name>. suno-voice usa /v1/suno/voice/generate. suno-speech usa a rota padrão, /v1/suno-speech.
instagram-post, tiktok-post, youtube-upload, linkedin-post, x-post, facebook-post, telegram-post, publish-social/v1/social/publish
ugc-creator, ugc-script, ugc-clips, ugc-clip, ugc-cards/v1/ugc/creator, /v1/ugc/script e assim por diante. Só no Nodaro Cloud.
render-video com um planType/v1/render-video/plan

A rota de publicação precisa de uma platform. Um nó de rede social de uma única plataforma, como x-post, a preenche a partir do próprio tipo quando você a omite. publish-social usa a platform que você envia.

Tipos de nó que não são executados sozinhos. Um tipo de nó sem rota própria é rejeitado com um NodaroError cujo code é node_not_runnable, sem chamar a API. A mensagem diz o que executar no lugar:

  • modify-image é executado por image-to-image, ou por edit-image para o modelo nano-banana-edit.
  • upscale-image e remove-background são executados por edit-image.
  • image-to-video é executado por generate-video.
  • composite, manual-edit e paint-mask só são executados dentro de um workflow. scene e generative-pipeline só são executados dentro de um pipeline.

Os tipos de nó que só são executados dentro de um workflow, como entradas, gatilhos, utilitários e seletores (upload-image, combine-text), são rejeitados da mesma forma assim que a API responde que não tem rota para eles. Um 404 sobre um recurso inexistente, como o id de um personagem que não existe, continua sendo um NotFoundError.

Um modelo que esta implantação não oferece, ou que um administrador desativou, é recusado antes de qualquer crédito ser reservado. A chamada é rejeitada com ModelUnavailableError, com code igual a model_not_available ou model_disabled. Escolha outro modelo: tentar de novo não muda nada.

O que volta. A maioria dos tipos de nó é assíncrona: o resultado traz um jobId, e um worker faz a geração. Consulte client.jobs.getStatus(jobId) periodicamente até a tarefa terminar, ou use runAndWait(). Alguns tipos de nó síncronos, como meta-ads-scrape, retornam o resultado completo imediatamente, sem jobId. Verifique se há um jobId para decidir o que fazer.

Correções de parâmetros. Nos tipos de nó de imagem (generate-image, image-to-image e edit-image), o servidor pode corrigir um valor que o modelo escolhido não aceita. A execução continua com o valor corrigido, e os créditos reservados correspondem a ele. O resultado então traz adjustments, com uma entrada por campo corrigido:

const result = await client.nodes.run("generate-image", {
  prompt: "A snow leopard",
  provider: "gpt-image-2",
  aspectRatio: "3:2",
})
if ("adjustments" in result && result.adjustments?.length) {
  for (const a of result.adjustments) {
    console.warn(`${a.field}: ${a.from} -> ${a.to ?? "(dropped)"} (${a.reason})`)
  }
}

Cada ajuste tem field (aspectRatio, resolution, quality ou duration), from, to e reason. adjustments não aparece quando nada mudou.

Lança InsufficientCreditsError quando a conta não consegue pagar, StorageExceededError quando o armazenamento está cheio e JobBlockedError quando uma política de conteúdo da implantação recusa a requisição. Veja Erros.

quote(type, params?)

Calcula o preço de uma execução antes de você iniciá-la, com POST /v1/quote. Passe exatamente o corpo que você passaria para run. A plataforma calcula o preço com o próprio código da rota de execução: a validação, a medição dos clipes de referência, o ID de crédito e o valor. Nada é iniciado e nada é cobrado. Só no Nodaro Cloud.

quote(type: string, params?: Record<string, unknown>): Promise<NodeQuote>

O método é tipado para text-to-video, generate-video, video-to-video, video-upscale (a finalização em 1080p de um rascunho do Seedance 2.5 tem o preço calculado a partir do rascunho) e edit-image. ai-avatar, cinematic-avatar e switchx recebem os corpos de execução deles como são. split-into-layers também pode ser cotado, com o corpo que client.media.splitIntoLayers aceita. Esses são os tipos que a plataforma consegue cotar hoje. Qualquer outro tipo é rejeitado com 400 quote_unsupported. Um corpo, modelo ou nó que a execução recusaria é rejeitado com o próprio 400 ou 403 da execução.

const q = await client.nodes.quote("video-to-video", {
  videoUrl, prompt: "make it black and white", provider: "seedance-2-5", resolution: "480p",
})
q.reserve   // credits held when the run starts
q.expected  // what the run should actually cost, when known

Um aviso settles_to_actual indica um reserve que é o máximo que a execução pode custar: ela é cobrada pelo que entregar, e o resto é reembolsado. Sem ele, reserve é o que a execução é cobrada quando termina.

// Nodaro Image Upscale: the exact price of this picture at this factor.
// The platform reads the picture to measure it, and stores nothing.
const up = await client.nodes.quote("edit-image", {
  provider: "nodaro-image-upscale", imageUrl: "https://example.com/photo-1024.png", upscaleFactor: "2",
})
up.identifier // "nodaro-image-upscale:2K" for a 1024 × 1024 picture

// Split into Layers: the hold, the most the run can cost (warning settles_to_actual).
const split = await client.nodes.quote("split-into-layers", { imageUrl: "https://example.com/poster.png", maxLayers: 5 })
split.identifier // "split-into-layers:1k:6": 5 layers and the base at 1K

Onde o Nodaro Image Upscale não é oferecido, a cotação é rejeitada com o 403 model_not_available da execução (ModelUnavailableError) antes de a imagem ser lida. Um link para outro site segue a configuração de importação de links da implantação.

NodeQuote é { identifier, reserve, expected?, adjustments, warnings }. Veja Cotações de execução para cada campo e código.

runAndWait(type, params?, opts?)

Executa um nó assíncrono até o fim. O método chama run(), pega o jobId e consulta client.jobs.getStatus() periodicamente até a tarefa terminar. Ele resolve com a saída da tarefa quando o status é completed.

runAndWait(type: string, params?: Record<string, unknown>, opts?: RunAndWaitOptions): Promise<NodeJobOutput>

Propriedade

Tipo

const output = await client.nodes.runAndWait(
  "generate-video",
  { prompt: "Rain falls on a neon street at night", provider: "seedance-2-fast", duration: 4 },
  { onProgress: (s) => console.log(`${s.progress ?? 0}%`) },
)
console.log(output.videoUrl, output.thumbnailUrl)

Em uma tarefa de imagem, NodeJobOutput também traz o tamanho da imagem em pixels, para que um cliente possa montar uma grade antes de as imagens carregarem:

CampoTipoDescrição
imageUrlstringA imagem, ou a primeira quando a tarefa criou várias.
imageUrlsreadonly string[]Todas as imagens, quando a tarefa criou mais de uma.
width, heightnumberO tamanho em pixels de imageUrl como foi armazenada, com a orientação EXIF aplicada. Uma marca-d'água do plano gratuito está incluída.
imagesreadonly JobOutputImage[]Um { url, width?, height? } por item de imageUrls, na mesma ordem. Um item sem tamanho não pôde ser medido.

Os quatro campos de tamanho são opcionais. Tarefas mais antigas não os têm, e o servidor nunca adivinha um tamanho que não conseguiu ler.

const output = await client.nodes.runAndWait("generate-image", { prompt: "a snow leopard in the mountains" })
console.log(output.imageUrl, output.width, output.height)
for (const image of output.images ?? []) console.log(image.url, image.width ?? "?", image.height ?? "?")

A saída é um NodeJobOutput: imageUrl para nós de imagem, videoUrl e thumbnailUrl para nós de vídeo, audioUrl para nós de áudio, além de quaisquer outros campos que o nó grave. O nó Separação de áudio, por exemplo, adiciona uma URL por stem, como vocalUrl e instrumentalUrl.

O método lança estes erros tipados:

ErroQuando
NodaroError com o código batch_requires_run_batch_and_waitUma requisição de generate-image com count acima de 1 ou com models cria várias tarefas. runAndWait() a recusa antes de qualquer envio. Use runBatchAndWait().
InsufficientCreditsError, StorageExceededError, JobBlockedErrorA requisição de execução foi recusada, antes de qualquer consulta.
ModelUnavailableErrorEsta implantação não oferece o modelo, ou um administrador o desativou. A execução é recusada antes de os créditos serem reservados. Escolha outro modelo.
JobFailedErrorA tarefa terminou como failed ou cancelled. O erro traz o jobId e a mensagem de erro da tarefa.
JobTimeoutErrorO tempo de maxMs passou. A tarefa não é cancelada.
JobAbortedErrorO seu signal disparou. A tarefa não é cancelada.
JobHeldErrorA tarefa está retida para revisão humana, em implantações com política de conteúdo.

Recuperações lentas. Às vezes um modelo entrega o resultado depois que o worker já desistiu dele. A tarefa então fica em processing com recovering: true enquanto a plataforma a recupera, o que pode levar dezenas de minutos em modelos lentos. Se um JobTimeoutError encerrar a sua espera, busque a tarefa mais tarde com client.jobs.get(jobId) ou aumente maxMs.

runMany(type, paramsList, opts?)

Inicia várias execuções de um tipo de nó ao mesmo tempo e aguarda todas, por exemplo para gerar uma grade de candidatos. Cada entrada é executada por runAndWait().

runMany(type: string, paramsList: Record<string, unknown>[], opts?: RunAndWaitOptions): Promise<RunManyResult[]>

Propriedade

Tipo

const results = await client.nodes.runMany("generate-image", [
  { prompt: "A snow leopard at sunrise" },
  { prompt: "A snow leopard at golden hour" },
  { prompt: "A snow leopard at blue hour" },
])
for (const { jobId, output } of results) console.log(jobId, output.imageUrl)

O método resolve quando todas as execuções terminam, com um { jobId, output } por entrada, na mesma ordem da lista que você passou. Ele rejeita assim que qualquer execução falha, com os mesmos erros de runAndWait(). Uma entrada que é ela própria um lote, com count acima de 1 ou com models, é recusada antes de qualquer envio. Para escolher o melhor resultado depois, passe as URLs para client.reduce.run().

runBatchAndWait(type, params, opts?)

Cria várias imagens em uma única chamada do Gerar imagem e aguarda cada uma delas. Use count para 1 a 4 imagens, cada uma em sua própria tarefa. Use models para enviar a mesma requisição a 2 a 4 modelos de imagem em vez de um único provider. Com os dois, count vale por modelo, até 8 imagens no total.

runBatchAndWait(
  type: "generate-image",
  params: GenerateImageParams,
  opts?: RunAndWaitOptions,
): Promise<GenerateImageBatchOutput>

O método envia o lote uma vez e depois aguarda cada tarefa do mesmo jeito que runAndWait() aguarda. O lote é conferido com o seu saldo e cobrado inteiro ou não é cobrado. Com opts.idempotencyKey, a imagem número i recebe a chave <key>:<i>, então uma nova tentativa retorna as mesmas tarefas e não cobra nada de novo. Um presetId se combina com as duas opções: count imagens da requisição da predefinição, ou a predefinição aplicada uma vez por modelo.

const { batch, results } = await client.nodes.runBatchAndWait(
  "generate-image",
  { prompt: "a lighthouse at dusk", models: ["gpt-image-2", "flux-2-max"], count: 2, seed: 41 },
  { idempotencyKey: crypto.randomUUID() },
)
console.log(batch.batchId, batch.totalCredits)
for (const r of results) {
  if (r.status === "completed") console.log(r.model, r.output.imageUrl)
  else console.warn(r.model, r.jobId, r.error.message)
}

Ele resolve com { batch, results }:

  • batch é a resposta do envio, um GenerateImageBatchResult. Tem jobId (a primeira tarefa), jobIds (modelo por modelo, depois imagem por imagem), batchId, groups ({ model, jobIds, credits?, adjustments? } por modelo) e totalCredits. nodes.run("generate-image", …) retorna o mesmo objeto quando os parâmetros definem count acima de 1 ou models.
  • results contém um BatchJobOutcome por tarefa, na ordem de batch.jobIds. Cada um é { jobId, model, status: "completed", output } ou { jobId, model, status: "error", error }. O error é o JobFailedError, JobHeldError ou JobTimeoutError que encerrou a espera. Uma imagem que falha nunca descarta as outras.

Ele só rejeita antes de qualquer tarefa existir, com os erros do próprio envio, como InsufficientCreditsError com o total do lote em required. Também rejeita com JobAbortedError quando o seu signal dispara. Uma requisição de uma única imagem é recusada antes de qualquer envio, com o código not_a_batch: aguarde-a com runAndWait(). Com um seed, a imagem i usa seed + i. Encontre as tarefas de um lote depois com client.jobs.list({ batchId }).

Parâmetros tipados

Estes tipos de nó têm parâmetros tipados, então o seu editor de código completa e verifica os campos deles. Todos os outros tipos de nó recebem um objeto simples; os campos são os campos de entrada do nó, listados em inputSchema e na página do nó na Referência de nós. Os nós de cena 3D também têm parâmetros tipados: veja Cenas 3D.

Tipo de nóTipo do parâmetroPágina do nó
generate-imageGenerateImageParamsGerar imagem
image-to-imageImageToImageParamsModificar imagem
edit-imageEditImageParamsUpscale de imagem
split-imageSplitImageParams
generate-maskGenerateMaskParamsGerar máscara
generate-videoGenerateVideoParamsGerar vídeo
text-to-videoTextToVideoParamsGerar vídeo
video-to-videoVideoToVideoParamsVídeo para vídeo
assemble-narrated-videoAssembleNarratedVideoParamsMontar vídeo narrado
video-depthVideoDepthParamsProfundidade de vídeo
video-upscaleVideoUpscaleParamsUpscale de vídeo

Todo objeto de parâmetros tipados também aceita outros campos da rota. O servidor valida o corpo completo.

GenerateImageParams

Propriedade

Tipo

strength e guidanceScale também são tipados em GenerateImageParams.

Formatos de arquivo de imagem

GenerateImageParams e ImageToImageParams tipam outputFormat (ImageOutputFormat). O padrão é "png", ou "jpeg", "webp", "gif" ou "svg" nos modelos cujo outputFormats o lista em client.models.list(). Hoje, esses modelos são o GPT Image 2.6 Flare e o Sunburst.

  • Um GIF aceita gifFrames (de 2 a 16) e gifFrameDurationMs (de 20 a 2.000 ms, em passos de 10). Um GIF é quadrado, com 512×512 por quadro. O aspectRatio e o resolution dele são ignorados, e adjustments informa isso.
  • Um SVG aceita svgLevel (ImageSvgLevel): "standard", "detailed" ou "max".
  • Um fundo transparente só é mantido em PNG e WebP.
  • Não é possível usar máscara com um GIF ou um SVG. A requisição é recusada com 400.

A saída da tarefa concluída informa o tipo do arquivo em imageMimeType. Para um GIF ou um SVG, ela traz também uma imagem fixa PNG em thumbnailUrl. O preço de um GIF depende da qualidade e da faixa em que cai o número de quadros: 2 a 8, 9 a 12 ou 13 a 16. O nó Gerar imagem mostra o preço antes de executar.

await client.nodes.runAndWait("generate-image", {
  prompt: "a waving flag",
  provider: "gpt-image-2-6-flare",
  outputFormat: "gif",
  gifFrames: 12,
} satisfies GenerateImageParams)

Predefinições no Gerar imagem

presetId aplica uma predefinição de nó exatamente como o editor faz: o prompt, o texto antes e depois, os padrões dos marcadores, o estilo, o prompt negativo e as configurações. A tarefa então corresponde ao Executar do editor. Use um id embutido de presets.listFactory("generate-image") ou uma das suas próprias predefinições. Os campos que você passa substituem os da predefinição.

Um marcador sem padrão precisa de um valor em presetVariables. Sem ele, a chamada falha com 400 preset_variables_required, que cita o marcador.

await client.nodes.runAndWait("generate-image", {
  presetId: "generate-image/logo-wordmark",
  presetVariables: { BRAND: "Acme" },
})

GenerateVideoParams

A via de imagem para vídeo: um quadro inicial, um quadro final opcional e referências.

Propriedade

Tipo

TextToVideoParams

A via de vídeo só com prompt, POST /v1/text-to-video. O prompt é obrigatório, e os quadros inicial e final ficam com o generate-video. Um modelo sem modo de texto para vídeo responde 400 image_required.

Propriedade

Tipo

TextToVideoParams aceita contentPolicyRewrite?: boolean. Quando ele está ausente ou é true, uma recusa por direitos autorais é tentada de novo uma vez com um prompt reescrito. Com false, uma recusa por direitos autorais faz a tarefa falhar.

Tipo de tarefa de referência do Seedance 2.5

GenerateVideoParams e TextToVideoParams aceitam referenceTaskType?: "auto" | "reference" | "edit" | "extend". Ele diz ao seedance-2-5 para que serve a mídia de referência, em vez de deixar isso para o prompt. Todos os outros modelos o ignoram, e o mesmo vale para uma execução sem mídia de referência. Um quadro inicial ou final não conta como mídia de referência.

  • "auto", o padrão, não declara nada.
  • "reference" mantém o seu aspectRatio e a sua duration. Com duration Automática (-1), a execução é reservada na saída mais longa que o modelo consegue fazer, e cobrada pelo que fizer.
  • "edit" edita o vídeo de referência no formato e na duração do próprio vídeo: aspectRatio vira "adaptive" e duration vira Automática. Todos os vídeos de referência precisam ter de 4 a 30 segundos. Caso contrário, nada é declarado, e a execução mantém a proporção e a duração que você enviou.
  • "extend" continua o vídeo de referência no formato do próprio vídeo, em uma duração definida. Uma duration Automática ou ausente vira a duração padrão do modelo. Você recebe só a continuação, não a origem emendada nela. Para os dois em um só vídeo, execute extend-video.
  • edit e extend precisam de um vídeo de referência. Um rascunho (draft: true) declara o tipo exatamente como a mesma execução sem draft, em 480p.

O que eles mudam volta em result.adjustments, e nodes.quote calcula o preço do corpo do mesmo jeito que a execução. Veja Tipo de tarefa de referência do Seedance 2.5.

await client.nodes.run("generate-video", {
  provider: "seedance-2-5",
  prompt: "remove the sign on the wall",
  referenceVideoUrls: [clipUrl],
  referenceTaskType: "edit",
} satisfies GenerateVideoParams)

Rascunhos do Seedance 2.5

GenerateVideoParams e TextToVideoParams aceitam draft: true. Em seedance-2-5, a execução é um rascunho em 480p pelo preço de uma execução em 480p. Finalize a tentativa de que você gostar com run("video-upscale", { provider: "seedance-2-5-hd", sourceJobId }): a mesma tentativa, renderizada de novo em 1080p, com preço calculado pela duração do rascunho. Uma origem que não é um rascunho seu já concluído é recusada com um 4xx antes de qualquer cobrança. Veja Modo rascunho do Seedance 2.5.

const draft = await client.nodes.run("generate-video", { prompt, provider: "seedance-2-5", draft: true, duration: 8 })
// Wait for the draft and review it. When you like the take, finalize it at 1080p.
if ("jobId" in draft) {
  const final = await client.nodes.runAndWait("video-upscale", { provider: "seedance-2-5-hd", sourceJobId: draft.jobId })
  console.log(final.videoUrl)
}

Upscale de vídeo com Topaz. VideoUpscaleParams aceita targetResolution ("720p", "1080p" ou "4k", o lado menor do quadro, padrão 1080p) e targetFps (de 15 a 60, por padrão a taxa do próprio vídeo de origem): run("video-upscale", { videoUrl, targetResolution: "4k", targetFps: 60 }). O Topaz é medido. Veja Upscale de vídeo › Créditos. upscaleFactor está obsoleto. Ele ainda é aceito e aplicado ao lado menor do vídeo de origem.

Nodaro Video Upscale. provider: "nodaro-video-upscale" aceita targetResolution "1080p" (padrão), "2k" ou "4k", o quadro de saída. Um valor que ele não aceita, como "720p", roda em 1080p: run("video-upscale", { provider: "nodaro-video-upscale", videoUrl, targetResolution: "2k" }).

  • Ele aceita clipes de até 60 segundos e 50 MB. O preço é por segundo do clipe, e o valor reservado é o valor cobrado.
  • Ele só é oferecido onde models.list o lista. Nos outros lugares, a solicitação é recusada com 403 model_not_available, um ForbiddenError.
  • As outras recusas: 400 para um clipe acima de um limite ou que não pode ser lido (video_too_long, video_too_large, video_unreadable), e 403 link_imports_disabled para um link para outro site onde a implantação desligou esses links.
  • Um clipe que a política de upload da implantação recusa responde 422 upload_blocked. Um clipe que não pôde ser buscado agora responde 429 input_busy, ou 503 input_timed_out ou input_failed: envie a mesma solicitação de novo.
  • Toda recusa vem antes de qualquer cobrança. "2k" é um alvo só deste provedor: Topaz e VEO continuam respondendo 400 a ele.

VideoToVideoParams

A via de edição de vídeo, POST /v1/video-to-video. Uma edição seedance-2-5 é montada no servidor, então você envia o mesmo corpo que para qualquer outro modelo de edição. Veja Vídeo para vídeo.

Propriedade

Tipo

O tipo também traz audio, multiShots, videoEditDuration, audioSetting e promptExtend para os modelos que os aceitam, além de sessionId e origin. Qualquer outro modelo recusa as três listas de referências. A numeração das referências e os limites estão em Vídeo para vídeo.

Rotas de imagem tipadas

image-to-image, edit-image, split-image e generate-mask têm sobrecargas tipadas em run. As três que iniciam uma tarefa também as têm em runAndWait. Cada tipo de parâmetros aceita os próprios vocabulários da plataforma, como ModifyImageProvider, ImageEditProvider, ImageAspectRatio e ImageResolution, que o SDK reexporta. Qualquer outro campo da rota continua sendo repassado.

A verificação em tempo de compilação vale quando o corpo é tipado como o tipo de parâmetros: const params: EditImageParams = …, ou { … } satisfies EditImageParams em linha. Um corpo escrito direto na chamada que a sobrecarga tipada rejeita ainda compila. Ele cai na sobrecarga sem tipo run(type: string, …), e a rota responde 400. Use satisfies para ter a verificação.

  • image-to-image, edit-image e generate-mask. run responde ImageJobStarted, ou seja, { jobId: string; adjustments? }, então result.jobId não precisa de conversão de tipo.
  • ImageToImageParams exige imageUrl e prompt. O maskUrl dele (o branco é a área a mudar) é enviado ao modelo como a máscara própria do modelo. Só ideogram-edit, flux-fill, gpt-image-2-6-flare-i2i e gpt-image-2-6-sunburst-i2i o usam. No GPT Image 2.6, o resto da imagem é mantido exatamente como estava, e o resultado tem o tamanho da origem. A execução mantém o formato da foto e é renderizada e cobrada no tamanho mais próximo do da foto. adjustments informa isso. Uma máscara não custa nada a mais. Ele aceita outputFormat e os campos de GIF e SVG como GenerateImageParams.
  • EditImageParams tem uma de duas formas. Ele aceita imageUrl para todos os modelos, exceto as operações de tarefa do Grok. Para essas, ele aceita taskId com provider: "grok-2-edit" | "grok-2-segment": o ID de tarefa de uma geração anterior do Grok Imagine 2, guardado nos dados de saída dessa tarefa. Um corpo tipado que envia os dois, ou um taskId com outro modelo, não compila. O modelo padrão é recraft-upscale. prompt é obrigatório para nano-banana-edit e grok-2-edit. maskIndexes é só para grok-2-edit.
  • upscaleFactor (UpscaleFactor: "1", "2", "4" ou "8") é 1, 2 ou 4 no topaz-image-upscale, e 1, 2, 4 ou 8 no nodaro-image-upscale. Um fator que o modelo não aceita é um 400 validation_error. O nodaro-image-upscale tem o preço calculado pelo tamanho da saída. Ele recusa uma saída acima de 67.108.864 pixels, ou de 16.384 pixels em um lado, com 400 image_too_large antes de qualquer cobrança. Veja Nodaro Image Upscale.
  • split-image é gratuito e responde na hora. Ele não cria tarefa, então runAndWait não se aplica. run responde SplitImageResult, ou seja, { images: { name, url }[] }, um PNG por bloco, na ordem de names. names precisa ter exatamente gridCols × gridRows entradas, e gridCols e gridRows vão cada um de 1 a 6.
  • generate-mask é a forma do SDK de iniciar uma tarefa do Gerar máscara. runAndWait("generate-mask", …) resolve GenerateMaskJobOutput: maskUrl, o PNG da máscara em que o branco é o objeto, e imageUrl, a origem repassada sem mudanças.
import type { EditImageParams, GenerateImageParams, GenerateMaskParams } from "@nodaro/sdk"

const { maskUrl } = await client.nodes.runAndWait("generate-mask", { imageUrl, prompt: "the red car" } satisfies GenerateMaskParams)
await client.nodes.runAndWait("generate-image", { prompt: "a blue car", baseImageUrl: imageUrl, maskUrl } satisfies GenerateImageParams)
const { jobId } = await client.nodes.run("edit-image", { imageUrl, provider: "topaz-image-upscale", upscaleFactor: "4" } satisfies EditImageParams)
await client.nodes.runAndWait("edit-image", { imageUrl, provider: "nodaro-image-upscale", upscaleFactor: "8" } satisfies EditImageParams)

VideoDepthParams

Transforma um clipe em um vídeo de profundidade, o que está perto claro e o que está longe escuro (POST /v1/video-depth). A tarefa concluída tem videoUrl e thumbnailUrl. Veja Profundidade de vídeo para os preços e os limites de duração.

Propriedade

Tipo

Uma configuração que o provedor escolhido não aceita é ignorada, então trocar de provedor nunca faz uma requisição falhar. Um valor fora das listas acima é um 400 validation_error. O clipe é medido antes de qualquer reserva de créditos. Um clipe longo demais responde 400 video_too_long: mais de 2.400 quadros ou 300 segundos em video-depth-anything, e mais de 80 segundos em depth-anything-frames. Um clipe que não pode ser lido responde 400 video_unreadable.

const { videoUrl } = await client.nodes.runAndWait("video-depth", {
  videoUrl: "https://cdn.example.com/clip.mp4",
  colormap: "turbo",
  resolution: "720p",
})

AssembleNarratedVideoParams

Junta blocos de vídeo com narração em um único vídeo. A execução é cobrada pelo número de blocos e custa de 44 a 143 créditos: 3 unidades, mais uma unidade a cada 6 blocos ou fração de 6. Veja Montar vídeo narrado para saber como cada bloco é ajustado à sua narração.

Propriedade

Tipo

Referências

generate-image, generate-video e text-to-video aceitam referências do jeito que o editor as conecta. O servidor as transforma em diretivas numeradas no prompt, como @image_1, então você não precisa escrever “A imagem 1 é...”.

  • connectedReferences é uma lista de entradas ConnectedReference, o formato de referência conectada do editor, exportado pelo SDK. O servidor remove duplicatas e mantém quantas o modelo aceitar. referenceOrder define a ordem delas pelo ID.
  • Bloqueio de identidade. Uma entrada pode trazer identityLock: { enabled: true, text? }. O servidor então adiciona uma linha curta que diz ao modelo para manter a identidade dessa referência. text substitui o texto padrão, e {ref} dentro dele representa o nome da referência. O bloqueio vem desativado por padrão.
  • describedReferences recebe até 10 entradas { name, description } para assuntos que você consegue nomear, mas dos quais não tem imagem, como um papel em um roteiro. Cada uma vira uma linha Name — description. no prompt. Mantenha o nome no texto do prompt, para que o modelo saiba quem é.
  • descriptionOverride em uma entrada de referência substitui a descrição armazenada dela só nesta execução.
  • Legendas para referências de vídeo e áudio. referenceVideoCaptions e referenceAudioCaptions seguem a ordem de referenceVideoUrls e referenceAudioUrls. Cada legenda aparece no prompt como @video_1: caption. ou @audio_1: caption..
  • Mencione uma referência de imagem no prompt. No generate-image, dê um nome a uma referência e mencione-a como @<name>:<index> ou @<name>:<index>:<role>, por exemplo @town:1:background. A menção insere essa referência, ou o papel dela, naquele ponto do prompt. ~lock e ~nolock funcionam como nas menções de personagem.

Veja Papéis de referência para os papéis que você pode usar e Personagens consistentes para trabalhar com identidade.

Direção

generate-image, generate-video e text-to-video aceitam um objeto direction com IDs de seletor em vez de palavras. O Nodaro escreve no prompt um texto testado para cada ID, então o seu código envia IDs e o texto continua sempre atualizado.

await client.nodes.runAndWait("generate-image", {
  prompt: "A detective waits under a street lamp",
  direction: { shotSize: "wide-shot", timeOfDay: "golden-hour", mood: "suspicious" },
})
  • As chaves são dimensões de seletor, como shotSize, lightingStyle, style, mood, photographer ou era. As rotas de vídeo adicionam chaves de movimento, como cameraMotion, actionFx, transition, loopSubject e as chaves temporal.
  • Os valores são um ID ou um array de IDs. Uma dimensão que aceita vários valores mantém no máximo o próprio limite e descarta o resto. A requisição só é recusada acima de 8 valores por chave ou de 100 caracteres por ID.
  • Chaves e IDs desconhecidos são ignorados, não recusados. Um direction vazio deixa o seu prompt inalterado.
  • Um único mapa serve para imagens e vídeo. Uma chave só de imagem fixa enviada a uma execução de vídeo é aceita e não adiciona nada.
  • extend-video não recebe direction, porque o prompt dele continua um clipe existente.
  • As suas próprias paletas e painéis de inspiração funcionam no generate-image. Defina colorLook como paletteDirectionId(id) ou style como moodboardDirectionId(id). Veja paletas e painéis de inspiração.

Leia os IDs válidos em client.pickerCatalogs. Veja Catálogos de seletores para todas as dimensões.

Assunto

GenerateImageParams e TextToVideoParams tipam um subject opcional, com o tipo exportado Subject. Ele diz quem está na tomada: a pessoa, o figurino e a beleza dela e os objetos de cena no quadro, como um mapa simples de campo de seletor para ID de catálogo. Você nunca escreve texto de prompt para ele. O Nodaro escreve o texto e o coloca logo depois do seu prompt, antes de qualquer direction.

import type { Subject } from "@nodaro/sdk"

const subject: Subject = { type: "woman", age: "age-30s", hairBase: "base-short-straight", heldProp: "smartphone" }
await client.nodes.run("generate-image", { prompt: "on the seawall at dusk", subject })
  • Nomes de campos e IDs vêm dos catálogos de seletores. client.pickerCatalogs.get("person") e get("styling") listam o field de cada dimensão com os options[].id dela. get("held-prop"), get("material") e get("animal") gravam os IDs deles no valueField do catálogo: heldProp, material e animal.
  • Valores são um ID ou uma lista de IDs. IDs além do limite próprio de uma dimensão são descartados, não recusados. customAge é o único número, em anos, lido só com age: "age-custom".
  • Limites. Sem uma predefinição, a rota verifica o mapa. Mais de 128 chaves, uma chave com mais de 64 caracteres, mais de 8 IDs em uma chave ou um ID com mais de 100 caracteres gera um 400 validation_error. Chaves e IDs desconhecidos dentro desses limites são ignorados, e o input_data.subject da tarefa guarda exatamente os IDs que foram usados.
  • Com presetId, o seu subject substitui o da predefinição e é adicionado ao prompt da predefinição, como acontece com direction. Valores longos demais são descartados em vez de recusados, e o input_data não registra o assunto.

Veja Nós para todas as chaves e a ordem em que o texto é adicionado.

Nós de modelo de linguagem

run(type, params) envia cada tipo de nó de modelo de linguagem para a rota própria dele: /v1/<type> para generate-script, image-critic, qa-check e describe-to-picker, e um caminho mais longo para os outros. Você não precisa de client.request() para eles:

Tipo de nóEndpoint
llm-chat/v1/llm-chat/generate
after-effects/v1/after-effects/generate
motion-graphics/v1/motion-graphics/generate
lottie-overlay/v1/lottie-overlay/generate
3d-title/v1/3d-title/generate
image-to-text/v1/image-to-text/describe
video-composer/v1/scene-graph/generate
await client.nodes.run("generate-script", {
  prompt: "A 3-scene product launch script for a smart water bottle",
  reasoningEffort: "high",
})
  • reasoningEffort é "none", "low", "medium", "high", "xhigh" ou "max", conforme o modelo. Omita-o, ou envie um nível que o modelo não aceita, para usar o padrão do modelo. O esforço não tem preço próprio. Toda chamada de LLM é cobrada pelos tokens que usou, pela tarifa do modelo na via que a atendeu, então um esforço maior só custa mais pelos tokens que escreve. Em um modelo Claude, qualquer esforço executa a chamada na API do próprio fabricante, pela tarifa dessa via. Veja o nó Gerar texto - qualquer LLM para os modelos, e Como as chamadas de LLM são cobradas. Uma exceção: describe-to-picker e a versão em texto dele, text-to-picker, usam "high" quando você omite o campo e llmModel é claude-opus-5.5. Essa execução roda na própria API da Anthropic, pela tarifa dessa via. Envie outro nível para mudar isso. Qualquer outro modelo mantém o próprio padrão, incluindo o modelo padrão deles, o Gemini 3.8 Flash.
  • advancedMode: true executa um modelo Gemini ou Claude diretamente na API do fabricante. Só ali temperature, maxTokens e toda a faixa de esforço têm efeito completo. A chamada é cobrada pela tarifa por token dessa via. Um modelo sem essa opção responde 400 advanced_mode_unsupported. Enquanto o provedor do próprio modelo não aceita requisições, a chamada responde advanced_mode_unavailable em vez de rodar na via padrão: 400 logo de início, ou 502 no meio, reembolsado a menos que o provedor tenha cobrado a tentativa. Desative o Modo avançado para executar o modelo. O Descrever para seletor é a exceção: ali, uma execução do Claude que o provedor recusa passa para o Gemini 3.8 Flash, como acontece com o Modo avançado desativado.
  • Taxa de quadros do vídeo. llm-chat lê um quadro por segundo de um vídeo de referência, a menos que referenceVideoFps (acima de 0, até 24) peça mais. Ele precisa de advancedMode: true em um modelo Gemini. Sem isso, a chamada responde 400 video_fps_needs_advanced_mode. Mais quadros são mais tokens de entrada. A taxa de quadros não muda como o modelo ouve o som do vídeo. Veja Gerar texto - qualquer LLM.
  • Cotar uma chamada. client.credits.modelCosts([llmPriceKey(feature, model)]) retorna uma estimativa de uma chamada típica, listada em estimates. Mostre-a como ≈N. llmPriceKey vem de @nodaro/shared/llm-models. Veja Modelos e créditos.
  • A transmissão contínua não é encapsulada. O SDK não lê a resposta em transmissão contínua do nó Gerar texto - qualquer LLM. Para ela, use fetch com um fluxo legível.

Regras específicas de modelos

Alguns modelos de vídeo aceitam valores que os outros não aceitam. A página de cada modelo lista todas as opções e os preços.

  • Seedance 2 aceita resolution: "4k" e aspectRatio: "adaptive" ou "21:9". O Seedance 2 Fast e o Seedance 2 Mini renderizam só em 480p ou 720p.
  • Seedance 2.5 renderiza em 480p, 720p ou 1080p, gera até 30 segundos em uma chamada e aceita 30 referências de imagem, 10 de vídeo e 10 de áudio. Com um quadro inicial, ele usa a proporção desse quadro e recusa um aspectRatio explícito.
  • Seedance 2.5 Flash (seedance-2-5-flash) é o Seedance 2.5 mais rápido e mais barato. Ele roda até 30 segundos em uma chamada, em 480p ou 720p (o padrão), e 1080p renderiza e é cobrado em 720p. Ele aceita 10 imagens, 5 vídeos e 5 áudios de referência, e mais que isso é um 400 too_many_references antes de qualquer reserva. O áudio de referência tem de 2 a 30 segundos por clipe e 30 segundos no total. Ele não tem draft nem seed. Ele também é um modelo de edição em run("video-to-video").
  • MiniMax H3 (minimax-h3) aceita 9 referências de imagem, 3 de vídeo e 3 de áudio com resolution: "2K" (o padrão) ou "768P". Qualquer outro valor é renderizado e cobrado como 2K.
  • Wan 3.0 (wan-3 e o mais rápido wan-3-prime) aceita 10 referências de imagem, 5 de vídeo e 5 de áudio. As listas de referências não podem ser combinadas com imageUrl nem com endFrameUrl. duration é um número inteiro de 2 a 30, e resolution é 480p, 720p ou 1080p.
  • Gemini Omni Flash aceita a mesma requisição que o Gemini Omni: durações de 4, 6, 8 ou 10 segundos, de 720p a 4K, e só 16:9 ou 9:16.
  • Gemini Omni Flash 1.2 (gemini-omni-flash-1-2) é cobrado por segundo. Ele aceita qualquer duration em segundos inteiros de 3 a 15, 360p, 720p, 1080p ou 4k, e um aspectRatio de 16:9, 9:16 ou auto. Ele aceita até 6 imagens de referência, ou 5 junto com um vídeo de origem. Um quadro inicial sozinho, ou um quadro inicial e um final até 10 segundos, são quadros exatos. Com referências, ou acima de 10 segundos, os quadros entram na lista de referências e o prompt os nomeia. Um vídeo de origem é editado e cobrado pela própria duração, até 15 segundos, e videoTrimStart e videoTrimEnd escolhem o trecho. Ele aceita até 2 characterReferences, sem voice e nunca com um quadro inicial ou final, e eles não ocupam nenhuma das vagas de referência. Veja Editar um clipe.
  • Kling 4.0 (kling-4) gera a partir só do texto ou de materiais de referência. Ele aceita referenceImageUrls (até 10), referenceVideoUrls (até 5, cada um de 2 a 30 segundos), characterReferences (até 7, como sujeitos nomeados) e referenceAudioUrls (até 3). Mais de 15 materiais no total é um 400 antes de qualquer reserva. Um imageUrl ou endFrameUrl enviado entra nas imagens de referência. No kling-4 e no kling-4-flash, cada referência de personagem é montada a partir de imageUrl, bodyImageUrl e até 3 extraImageUrls, um quadro inicial é permitido, e voice é recusado. keepOriginalSound: true mantém o som próprio de um vídeo de referência. O primeiro clipe de áudio toca como trilha sonora por padrão. Ele é enviado como mais um vídeo de referência, então a execução é cobrada como uma execução com vídeo de referência, e os outros clipes continuam vozes nomeadas. audioSoundtrack: false mantém todos os clipes como amostras de voz. Uma execução com vídeo de referência cobra a saída mais o maior valor entre a saída e os clipes, pela tarifa de referência. Kling 4.0 Keyframes (kling-4-keyframes) aceita imageUrl, até 8 quadros intermediários como referenceImageUrls, em ordem, e endFrameUrl. O total de quadros é limitado pela duration, de 4 com 3 segundos a 10 a partir de 9 segundos, e mais que isso é um 400. Os dois aceitam uma duration de 3 a 30 (padrão 5) e uma resolution de 720p ou 1080p; qualquer outro valor renderiza 720p. aspectRatio é auto, 16:9, 9:16, 1:1 ou 21:9. O áudio está sempre ativado, e não há seed.
  • Kling 4.0 Flash (kling-4-flash) é o Kling 4.0 mais rápido e de menor custo. Um imageUrl sozinho é o quadro de abertura exato. Qualquer outra coisa roda no modo de referência: só um prompt, referenceImageUrls (até 10), referenceVideoUrls (até 5, de 2 a 20 segundos somados), characterReferences (até 7) ou um quadro inicial junto com eles. O modo de referência aceita 15 materiais no total. O clipe N de referenceAudioUrls (até 7) vira a voz da entrada N de characterReferences. Um personagem precisa de 2 a 4 imagens, ou de um videoUrl, para carregar uma voz. Caso contrário, o clipe dele é descartado, assim como qualquer clipe depois do último personagem. duration vai de 3 a 20 (padrão 5), e a saída é só em 720p; qualquer outro valor renderiza 720p. Não há quadro final, nem seed, nem audioSoundtrack.
  • Personagens em vídeo no Kling 4.0 e no Kling 4.0 Flash. O videoUrl de uma entrada de characterReferences é um clipe de 3 a 8 segundos em uma só tomada do personagem. Ele faz da entrada um sujeito criado a partir desse vídeo, com no máximo 3 por requisição. O clipe conta como um dos 5 vídeos de referência. O preço é o de uma entrada só com imagens, então ele não acrescenta nada, e qualquer outro modelo o recusa. Veja Personagens em vídeo.
  • PixVerse V6 Max (pixverse-v6-max) roda em run("generate-video") com um imageUrl como quadro inicial exato, e nenhum aspectRatio é enviado. Ele roda em run("text-to-video") com aspectRatio 16:9 (o padrão), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 ou 21:9. duration vai de 1 a 15 (padrão 5), resolution é 360p, 540p, 720p (padrão) ou 1080p (qualquer outro valor renderiza 720p), e seed vai de 0 a 2147483647. O áudio nativo fica ligado, a menos que sound: false (ou, sem sound, generateAudio: false), e ele muda o preço. Ele não aceita quadro final nem referências.
  • Grok Imagine 1.5 (grok-imagine-video-1.5) precisa de imageUrl, o quadro inicial exato. endFrameUrl é o quadro final exato, e a mesma URL nos dois faz um loop sem emenda. Até 4 quadros intermediários vão em referenceImageUrls, em ordem, espalhados pelo clipe em segundos inteiros. Um clipe de D segundos aceita no máximo D − 1, e o resto fica de fora. duration vai de 1 a 15 (padrão 8), resolution é 480p (padrão), 720p ou 1080p (qualquer outro valor renderiza 480p), e não há seed. Em 1080p ele aceita só o imageUrl: com quadro final, loop ou quadros intermediários, a execução é recusada com 400 start_frame_only_resolution antes de reservar créditos. Use 720p nesses casos.
  • Gemini Omni e Gemini Omni Flash (gemini-omni-video e gemini-omni-flash) mantêm o rosto de uma pessoa real com characterReferences. Passe até 3 entradas de { imageUrl, description, bodyImageUrl?, extraImageUrls?, name?, voice?, videoUrl? }. voice é { preset, description?, exampleLine? }, em que preset é um dos IDs de GEMINI_OMNI_VOICE_PRESETS de @nodaro/shared. Ele mantém uma mesma voz para esse personagem em todos os clipes. Só esses modelos, o gemini-omni-flash-1-2 (até 2, sem voice), o kling-4 e o kling-4-flash aceitam characterReferences. Qualquer outro modelo responde 400. No Gemini Omni, characterReferences não pode ser combinado com um quadro inicial (imageUrl). No Gemini Omni e no Gemini Omni Flash, um personagem usa 1 das 7 unidades de entrada do modelo, ou 2 com um bodyImageUrl, e imagens de referência e um vídeo de origem dividem essas unidades. Referências de personagem não acrescentam créditos. Use-as em vez de referenceImageUrls quando o rosto precisar continuar o mesmo.

Texto para fala. Quando você omite provider, o nó Texto para fala usa o ElevenLabs v4 para textos de até 10.000 caracteres. Textos mais longos passam para o ElevenLabs Turbo v2.5, cujo limite é de 40.000 caracteres, para não serem cortados. Um provider que você indicar é sempre usado. Envie provider: "elevenlabs-v3" para manter o ElevenLabs v3, cujo limite é de 5.000 caracteres.

Continuidade entre clipes. O Texto para fala também aceita previousText e nextText: as falas ditas logo antes e logo depois do clipe, com até 1.000 caracteres cada. Elas não são faladas. ElevenLabs v4, v4 Turbo, Turbo v2.5 e Multilingual v2 as usam para manter uma mesma entonação em clipes feitos separadamente. O ElevenLabs v3 e os modelos de fala Gemini as ignoram.

Modelos de fala Gemini. provider também aceita gemini-3-8-flash-lite-tts, gemini-3-8-flash-tts, gemini-3-1-flash-tts e gemini-2-5-pro-tts. Cada um fala só as próprias vozes nomeadas, listadas por voices.list({ model }); outra voice é um 400 antes de qualquer cobrança. Eles não aceitam languageCode, porque o texto decide o idioma, e não retornam marcações de tempo. styleDirection diz como o texto é falado: texto livre no 3.8, ou um dos estilos do modelo no 3.1 e no 2.5, que também aceitam pace, accent e audioProfile. As listas de cada modelo estão na ficha de recursos dele, getTtsCapabilities(provider).direction em @nodaro/shared. A direção não é falada nem cobrada. Os preços são por 1.000 caracteres; veja Texto para fala.

Tempos e arquivo de áudio. Com withTimestamps: true, o output_data.transcript da tarefa concluída traz o tempo de cada palavra (words[] com startMs e endMs), sem créditos extras. O outputFormat escolhe o arquivo de áudio: mp3_44100_128 (o padrão), mp3_44100_192 para uma taxa de bits de MP3 mais alta ou wav_24000 para um WAV sem compressão. Os créditos são os mesmos em todos os formatos. O audioUrl da tarefa termina em .mp3 ou .wav conforme o arquivo que voltou, e output_data.audioMimeType diz qual é (audio/mpeg ou audio/wav). Dê nome a um download a partir desse campo, não do formato que você pediu. Os valores estão em TTS_OUTPUT_FORMATS, em @nodaro/shared/models.

Scrapers e outros nós de entrada

Os nós de entrada são executados do mesmo jeito. Um scraper, como o nó Extrair da web, responde imediatamente: o resultado traz um jobId para o seu histórico e os próprios dados, então você pode usá-los sem consultas periódicas. Os campos da requisição são os campos de entrada do nó, listados em inputSchema.

Perguntas frequentes

Como gero uma imagem com o SDK do Nodaro?

Chame client.nodes.runAndWait com o tipo de nó generate-image e um prompt. A chamada resolve com a saída da tarefa, cujo imageUrl é a imagem gerada.

Qual é a diferença entre run e runAndWait?

run inicia o nó e retorna um jobId imediatamente. runAndWait inicia o nó, consulta a tarefa a cada 2 segundos e resolve com a saída quando a tarefa é concluída.

Quanto tempo o runAndWait espera?

Até 15 minutos, por padrão. Altere esse tempo com a opção maxMs. Esgotar o tempo não cancela a tarefa, que normalmente ainda é concluída no servidor.

Quais tipos de nó posso executar?

Chame client.nodes.list() para ver todos os tipos que o servidor aceita, com a categoria, o tipo de saída, os modelos e o custo em créditos de cada um. Todo nó da Referência de nós tem um tipo na API.

Como gero várias imagens em uma só chamada?

Chame client.nodes.runBatchAndWait com generate-image e count (de 1 a 4 imagens) ou models (de 2 a 4 modelos de imagem). O lote é cobrado inteiro ou não é cobrado, e uma imagem que falha nunca descarta as outras.

Como evito pagar duas vezes quando repito uma requisição?

Passe uma idempotencyKey nas opções de run ou runAndWait e reutilize a mesma chave ao repetir a requisição. A plataforma retorna a primeira execução em vez de iniciar uma segunda.

Última atualização

Nesta página