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étodo | O 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:
| Campo | Tipo | Descrição |
|---|---|---|
type | string | O tipo na API, como generate-image. Passe-o para run(). |
label | string | O nome do nó no editor. |
category | string | A categoria, como ai-image, ai-video, ai-audio, ai-text, processing ou parameter. |
description | string | Uma descrição de uma linha. |
outputType | string | text, image, video, audio, data ou none. |
creditCost | number | string | O 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. |
estimate | boolean | true 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". |
creditRate | NodeCreditRate | Para 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. |
providers | string[] | Os IDs dos modelos que o nó pode executar, para o parâmetro provider. |
capabilities | string[] | 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. |
maxDurationSec | number | A maior duração que o nó aceita, quando ele tem um limite. |
providerResolutions | Record<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 onlyPara 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 porimage-to-image, ou poredit-imagepara o modelonano-banana-edit.upscale-imageeremove-backgroundsão executados poredit-image.image-to-videoé executado porgenerate-video.composite,manual-editepaint-masksó são executados dentro de um workflow.sceneegenerative-pipelinesó 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 knownUm 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 1KOnde 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:
| Campo | Tipo | Descrição |
|---|---|---|
imageUrl | string | A imagem, ou a primeira quando a tarefa criou várias. |
imageUrls | readonly string[] | Todas as imagens, quando a tarefa criou mais de uma. |
width, height | number | O tamanho em pixels de imageUrl como foi armazenada, com a orientação EXIF aplicada. Uma marca-d'água do plano gratuito está incluída. |
images | readonly 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:
| Erro | Quando |
|---|---|
NodaroError com o código batch_requires_run_batch_and_wait | Uma 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, JobBlockedError | A requisição de execução foi recusada, antes de qualquer consulta. |
ModelUnavailableError | Esta 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. |
JobFailedError | A tarefa terminou como failed ou cancelled. O erro traz o jobId e a mensagem de erro da tarefa. |
JobTimeoutError | O tempo de maxMs passou. A tarefa não é cancelada. |
JobAbortedError | O seu signal disparou. A tarefa não é cancelada. |
JobHeldError | A 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, umGenerateImageBatchResult. TemjobId(a primeira tarefa),jobIds(modelo por modelo, depois imagem por imagem),batchId,groups({ model, jobIds, credits?, adjustments? }por modelo) etotalCredits.nodes.run("generate-image", …)retorna o mesmo objeto quando os parâmetros definemcountacima de 1 oumodels.resultscontém umBatchJobOutcomepor tarefa, na ordem debatch.jobIds. Cada um é{ jobId, model, status: "completed", output }ou{ jobId, model, status: "error", error }. Oerroré oJobFailedError,JobHeldErrorouJobTimeoutErrorque 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âmetro | Página do nó |
|---|---|---|
generate-image | GenerateImageParams | Gerar imagem |
image-to-image | ImageToImageParams | Modificar imagem |
edit-image | EditImageParams | Upscale de imagem |
split-image | SplitImageParams | |
generate-mask | GenerateMaskParams | Gerar máscara |
generate-video | GenerateVideoParams | Gerar vídeo |
text-to-video | TextToVideoParams | Gerar vídeo |
video-to-video | VideoToVideoParams | Vídeo para vídeo |
assemble-narrated-video | AssembleNarratedVideoParams | Montar vídeo narrado |
video-depth | VideoDepthParams | Profundidade de vídeo |
video-upscale | VideoUpscaleParams | Upscale 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) egifFrameDurationMs(de 20 a 2.000 ms, em passos de 10). Um GIF é quadrado, com 512×512 por quadro. OaspectRatioe oresolutiondele são ignorados, eadjustmentsinforma 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
Recusas por direitos autorais
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 seuaspectRatioe a suaduration. ComdurationAutomá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:aspectRatiovira"adaptive"edurationvira 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. UmadurationAutomá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, executeextend-video.editeextendprecisam de um vídeo de referência. Um rascunho (draft: true) declara o tipo exatamente como a mesma execução semdraft, 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.listo lista. Nos outros lugares, a solicitação é recusada com403 model_not_available, umForbiddenError. - As outras recusas:
400para um clipe acima de um limite ou que não pode ser lido (video_too_long,video_too_large,video_unreadable), e403 link_imports_disabledpara 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 responde429 input_busy, ou503 input_timed_outouinput_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 respondendo400a 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-imageegenerate-mask.runrespondeImageJobStarted, ou seja,{ jobId: string; adjustments? }, entãoresult.jobIdnão precisa de conversão de tipo.ImageToImageParamsexigeimageUrleprompt. OmaskUrldele (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-i2iegpt-image-2-6-sunburst-i2io 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.adjustmentsinforma isso. Uma máscara não custa nada a mais. Ele aceitaoutputFormate os campos de GIF e SVG comoGenerateImageParams.EditImageParamstem uma de duas formas. Ele aceitaimageUrlpara todos os modelos, exceto as operações de tarefa do Grok. Para essas, ele aceitataskIdcomprovider: "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 umtaskIdcom outro modelo, não compila. O modelo padrão érecraft-upscale.prompté obrigatório paranano-banana-editegrok-2-edit.maskIndexesé só paragrok-2-edit.upscaleFactor(UpscaleFactor:"1","2","4"ou"8") é 1, 2 ou 4 notopaz-image-upscale, e 1, 2, 4 ou 8 nonodaro-image-upscale. Um fator que o modelo não aceita é um400 validation_error. Onodaro-image-upscaletem 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, com400 image_too_largeantes de qualquer cobrança. Veja Nodaro Image Upscale.split-imageé gratuito e responde na hora. Ele não cria tarefa, entãorunAndWaitnão se aplica.runrespondeSplitImageResult, ou seja,{ images: { name, url }[] }, um PNG por bloco, na ordem denames.namesprecisa ter exatamentegridCols × gridRowsentradas, egridColsegridRowsvão cada um de 1 a 6.generate-maské a forma do SDK de iniciar uma tarefa do Gerar máscara.runAndWait("generate-mask", …)resolveGenerateMaskJobOutput:maskUrl, o PNG da máscara em que o branco é o objeto, eimageUrl, 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 entradasConnectedReference, o formato de referência conectada do editor, exportado pelo SDK. O servidor remove duplicatas e mantém quantas o modelo aceitar.referenceOrderdefine 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.textsubstitui o texto padrão, e{ref}dentro dele representa o nome da referência. O bloqueio vem desativado por padrão. describedReferencesrecebe 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 linhaName — description.no prompt. Mantenha o nome no texto do prompt, para que o modelo saiba quem é.descriptionOverrideem uma entrada de referência substitui a descrição armazenada dela só nesta execução.- Legendas para referências de vídeo e áudio.
referenceVideoCaptionsereferenceAudioCaptionsseguem a ordem dereferenceVideoUrlsereferenceAudioUrls. 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.~locke~nolockfuncionam 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,photographerouera. As rotas de vídeo adicionam chaves de movimento, comocameraMotion,actionFx,transition,loopSubjecte as chavestemporal. - 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
directionvazio 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-videonão recebedirection, porque o prompt dele continua um clipe existente.- As suas próprias paletas e painéis de inspiração funcionam no
generate-image. DefinacolorLookcomopaletteDirectionId(id)oustylecomomoodboardDirectionId(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")eget("styling")listam ofieldde cada dimensão com osoptions[].iddela.get("held-prop"),get("material")eget("animal")gravam os IDs deles novalueFielddo catálogo:heldProp,materialeanimal. - 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ó comage: "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 oinput_data.subjectda tarefa guarda exatamente os IDs que foram usados. - Com
presetId, o seusubjectsubstitui o da predefinição e é adicionado ao prompt da predefinição, como acontece comdirection. Valores longos demais são descartados em vez de recusados, e oinput_datanã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-pickere a versão em texto dele,text-to-picker, usam"high"quando você omite o campo ellmModelé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: trueexecuta um modelo Gemini ou Claude diretamente na API do fabricante. Só alitemperature,maxTokense 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 responde400 advanced_mode_unsupported. Enquanto o provedor do próprio modelo não aceita requisições, a chamada respondeadvanced_mode_unavailableem vez de rodar na via padrão:400logo de início, ou502no 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-chatlê um quadro por segundo de um vídeo de referência, a menos quereferenceVideoFps(acima de 0, até 24) peça mais. Ele precisa deadvancedMode: trueem um modelo Gemini. Sem isso, a chamada responde400 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 emestimates. Mostre-a como≈N.llmPriceKeyvem 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
fetchcom 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"easpectRatio: "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
aspectRatioexplí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), e1080prenderiza e é cobrado em 720p. Ele aceita 10 imagens, 5 vídeos e 5 áudios de referência, e mais que isso é um400 too_many_referencesantes de qualquer reserva. O áudio de referência tem de 2 a 30 segundos por clipe e 30 segundos no total. Ele não temdraftnemseed. Ele também é um modelo de edição emrun("video-to-video"). - MiniMax H3 (
minimax-h3) aceita 9 referências de imagem, 3 de vídeo e 3 de áudio comresolution: "2K"(o padrão) ou"768P". Qualquer outro valor é renderizado e cobrado como 2K. - Wan 3.0 (
wan-3e o mais rápidowan-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 comimageUrlnem comendFrameUrl.durationé um número inteiro de 2 a 30, eresolutioné480p,720pou1080p. - 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 qualquerdurationem segundos inteiros de 3 a 15,360p,720p,1080pou4k, e umaspectRatiode16:9,9:16ouauto. 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, evideoTrimStartevideoTrimEndescolhem o trecho. Ele aceita até 2characterReferences, semvoicee 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 aceitareferenceImageUrls(até 10),referenceVideoUrls(até 5, cada um de 2 a 30 segundos),characterReferences(até 7, como sujeitos nomeados) ereferenceAudioUrls(até 3). Mais de 15 materiais no total é um400antes de qualquer reserva. UmimageUrlouendFrameUrlenviado entra nas imagens de referência. Nokling-4e nokling-4-flash, cada referência de personagem é montada a partir deimageUrl,bodyImageUrle até 3extraImageUrls, um quadro inicial é permitido, evoiceé recusado.keepOriginalSound: truemanté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: falsemanté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) aceitaimageUrl, até 8 quadros intermediários comoreferenceImageUrls, em ordem, eendFrameUrl. O total de quadros é limitado peladuration, de 4 com 3 segundos a 10 a partir de 9 segundos, e mais que isso é um400. Os dois aceitam umadurationde 3 a 30 (padrão 5) e umaresolutionde720pou1080p; qualquer outro valor renderiza 720p.aspectRatioéauto,16:9,9:16,1:1ou21: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. UmimageUrlsozinho é 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 dereferenceAudioUrls(até 7) vira a voz da entrada N decharacterReferences. Um personagem precisa de 2 a 4 imagens, ou de umvideoUrl, para carregar uma voz. Caso contrário, o clipe dele é descartado, assim como qualquer clipe depois do último personagem.durationvai 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, nemaudioSoundtrack. - Personagens em vídeo no Kling 4.0 e no Kling 4.0 Flash. O
videoUrlde uma entrada decharacterReferencesé 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 emrun("generate-video")com umimageUrlcomo quadro inicial exato, e nenhumaspectRatioé enviado. Ele roda emrun("text-to-video")comaspectRatio16:9(o padrão),4:3,1:1,3:4,9:16,2:3,3:2ou21:9.durationvai de 1 a 15 (padrão 5),resolutioné360p,540p,720p(padrão) ou1080p(qualquer outro valor renderiza 720p), eseedvai de 0 a 2147483647. O áudio nativo fica ligado, a menos quesound: false(ou, semsound,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 deimageUrl, 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 emreferenceImageUrls, 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.durationvai de 1 a 15 (padrão 8),resolutioné480p(padrão),720pou1080p(qualquer outro valor renderiza 480p), e não há seed. Em1080pele aceita só oimageUrl: com quadro final, loop ou quadros intermediários, a execução é recusada com400 start_frame_only_resolutionantes de reservar créditos. Use720pnesses casos. - Gemini Omni e Gemini Omni Flash (
gemini-omni-videoegemini-omni-flash) mantêm o rosto de uma pessoa real comcharacterReferences. Passe até 3 entradas de{ imageUrl, description, bodyImageUrl?, extraImageUrls?, name?, voice?, videoUrl? }.voiceé{ preset, description?, exampleLine? }, em quepreseté um dos IDs deGEMINI_OMNI_VOICE_PRESETSde@nodaro/shared. Ele mantém uma mesma voz para esse personagem em todos os clipes. Só esses modelos, ogemini-omni-flash-1-2(até 2, semvoice), okling-4e okling-4-flashaceitamcharacterReferences. Qualquer outro modelo responde400. No Gemini Omni,characterReferencesnã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 umbodyImageUrl, 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 dereferenceImageUrlsquando 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.
Páginas relacionadas
Tarefas e execuções
Modelos e créditos
Nós
Referência de nós
CLI
Última atualização
Tarefas e execuções
Consulte, liste, avalie, cancele e exclua execuções do Nodaro em TypeScript, acompanhe workflows e receba webhooks assinados quando uma tarefa termina.
Apps e templates
Explore e execute apps publicados do Nodaro em TypeScript, leia o histórico de execuções, clone templates de workflow em um projeto e liste os tutoriais.