Erros
Todos os erros do SDK do Nodaro para TypeScript, com status HTTP, código e campos, e o que fazer com créditos, limites de taxa, conflitos e tarefas com falha.
Todo erro que o SDK do Nodaro lança para uma resposta da API é uma instância de NodaroError ou de uma das subclasses dele. Uma requisição que falha com um status de erro lança a subclasse correspondente ao status. As funções auxiliares que executam e esperam lançam subclasses próprias quando uma tarefa falha, excede o tempo limite ou é interrompida. Capture primeiro as classes específicas e NodaroError por último.
Todas as classes de erro
| Classe | Status | code | Campos extras | Quando é lançado |
|---|---|---|---|---|
NodaroError | Qualquer um | O código do servidor | A classe base, e qualquer erro sem uma classe mais específica | |
UnauthorizedError | 401 | unauthorized | O token está ausente, expirou ou é inválido | |
ForbiddenError | 403 | O código do servidor, ou forbidden | missingScope? | A permissão foi negada, ou falta um escopo a um token OAuth |
ModelUnavailableError | 403 | model_not_available ou model_disabled | O modelo que você escolheu não é oferecido, ou um administrador o desativou | |
ImportRefusedError | 403 | imports_blocked, import_source_disabled, link_imports_disabled ou um código rights_* | Uma importação de link foi recusada antes que qualquer coisa fosse buscada | |
NotFoundError | 404 | O código do servidor, ou not_found | O item não existe, ou você não pode vê-lo | |
RateLimitedError | 429 | O código do servidor, ou rate_limited | Requisições demais | |
InsufficientCreditsError | 402 | insufficient_credits, ou outro código 402 | required?, available? | A conta não consegue pagar a execução |
CreditCapExceededError | 402 | budget_exceeded, member_cap_exceeded ou user_allowance_exceeded | required?, available? | Um limite de gastos que outra pessoa definiu recusou a execução |
StorageExceededError | 413 | storage_exceeded | limitBytes?, reason? | O que você enviou não cabe: um armazenamento cheio, ou um arquivo acima do limite |
WorkflowConflictError | 409 | workflow_conflict ou production_busy | currentUpdatedAt?, currentVersion?, currentRecord? | Outra pessoa alterou o item antes |
AlreadyRunningError | 409 | already_running | executionId | A execução que você pediu para iniciar ou continuar ainda está em andamento |
AppRunVersionChangedError | 409 | app_run_version_changed | runVersion?, appVersion? | O Tentar novamente de uma execução de app foi recusado porque o app mudou de versão |
JobBlockedError | 422 | job_blocked | A política de conteúdo da implantação recusou a requisição | |
MediaTooLongError | 422 | media_too_long | Um envio grande tem mais de 30 minutos | |
LargeUploadUnavailableError | 409 ou 404 | large_upload_unavailable | Um arquivo acima de 500 MB, em um servidor sem caminho de envio grande | |
StudioOpError | 4xx | O código do servidor | opIndex | Uma operação de um lote do Studio foi recusada |
JobFailedError | 0 | job_failed | jobId, jobStatus | Uma tarefa que você estava esperando falhou ou foi cancelada |
JobTimeoutError | 0 | job_timeout | jobId, timeoutMs | Uma tarefa não terminou dentro de maxMs |
JobAbortedError | 0 | job_aborted | jobId? | Seu AbortSignal foi acionado durante a espera |
JobHeldError | 0 | job_held | jobId | Uma tarefa está retida para revisão humana |
StudioPreviewUnavailable | 0 | studio_preview_unavailable | A implantação não consegue gerar a prévia de um lote do Studio | |
StudioPreviewAppliedError | 0 | studio_preview_applied | applied | Um lote do Studio do qual você pediu a prévia foi aplicado |
Toda classe tem quatro campos: message, uma frase legível; code, uma string estável que você pode comparar; status, o status HTTP; e details. Um status igual a 0 significa que o erro não veio de uma resposta HTTP. Por exemplo, JobTimeoutError é lançado pelo próprio loop de consulta periódica do SDK.
details contém todos os campos do envelope de erro além de code e message, como o servidor os enviou. Exemplos são o slot de uma recusa de trend, as reasons de uma recusa de publicação e as issues de um erro de validação. Ele é {} quando o envelope não tinha mais nada, e em um erro que o próprio SDK criou.
try {
await client.trends.run(slug, request)
} catch (err) {
if (err instanceof NodaroError && err.code === "missing_slot") askFor(err.details.slot as string)
}O construtor é new NodaroError(message, code, status, details?).
Alguns status correspondem a uma única classe, seja qual for o código que o servidor enviou. Um 403 vira ForbiddenError, exceto um modelo recusado, que vira ModelUnavailableError, e uma importação de link recusada, que vira ImportRefusedError. Um 404 vira NotFoundError, um 429 vira RateLimitedError, e todo 413 vira StorageExceededError. ForbiddenError, NotFoundError e RateLimitedError mantêm o próprio code do servidor, como node_not_available, continuation_not_found ou rate_limit_exceeded. Eles usam forbidden, not_found e rate_limited só quando o servidor não enviou nenhum código. Um 409 só vira WorkflowConflictError com o código workflow_conflict ou production_busy. Um 409 already_running que indica um executionId vira AlreadyRunningError, e um 409 app_run_version_changed vira AppRunVersionChangedError. Erros com qualquer outro status, como 400 ou 503, e um 409 com qualquer outro código chegam como NodaroError com o code do próprio servidor.
Capturar os erros em ordem
import {
ForbiddenError,
InsufficientCreditsError,
ModelUnavailableError,
NodaroError,
NotFoundError,
RateLimitedError,
StorageExceededError,
UnauthorizedError,
} from "@nodaro/sdk"
try {
await client.workflows.run(workflowId)
} catch (err) {
if (err instanceof UnauthorizedError) {
redirectToLogin()
} else if (err instanceof ModelUnavailableError) {
showError("This model is not available. Choose another model.")
} else if (err instanceof ForbiddenError) {
if (err.missingScope) requestAdditionalScopes([err.missingScope])
else showError("You do not have permission to do this.")
} else if (err instanceof InsufficientCreditsError) {
showCreditPaywall({ required: err.required, available: err.available })
} else if (err instanceof RateLimitedError) {
await retryWithBackoff()
} else if (err instanceof StorageExceededError) {
if (err.reason === "file_too_large") showError("This file is too large.")
else showError(`Storage limit of ${err.limitBytes} bytes reached.`)
} else if (err instanceof NotFoundError) {
showError("Not found.")
} else if (err instanceof NodaroError) {
console.error(`API error ${err.status} (${err.code}): ${err.message}`)
} else {
throw err // a network failure or a timeout, not an API answer
}
}Uma requisição que excede o timeoutMs do cliente e uma falha de rede são rejeitadas com o erro do próprio ambiente de execução, como um AbortError ou um TypeError. Esses erros não são instâncias de NodaroError.
Autenticação e permissão
UnauthorizedError
HTTP 401. O token está ausente, expirou ou é inválido. Obtenha um novo token ou faça o usuário entrar de novo e, depois, tente outra vez.
ForbiddenError
HTTP 403. Quem chamou não tem permissão para isso. Quando um token OAuth não recebeu um escopo de que o endpoint precisa, missingScope indica esse escopo, por exemplo workflows:execute. Peça ao usuário que o aprove e tente de novo com o novo token. Veja Escopos e permissões ausentes.
Outros motivos incluem uma edição que não oferece o recurso e uma função abaixo da necessária. O code é o próprio código do servidor, por exemplo insufficient_scope ou node_not_available, para você decidir o que fazer a partir dele. Ele é forbidden só quando o servidor não enviou nenhum código.
ModelUnavailableError
HTTP 403 que recusa o modelo, não quem chama. O Nodaro responde antes de reservar qualquer crédito. Escolha outro modelo: tentar de novo, fazer uma recarga ou pedir um escopo mais amplo não muda nada.
code | Recusa |
|---|---|
model_not_available | Esta implantação não oferece o modelo. O modelo está fora da edição ou da superfície dela, ou o operador o ocultou. |
model_disabled | Um administrador desativou o modelo. |
ModelUnavailableError estende ForbiddenError, então uma verificação instanceof ForbiddenError que já existe ainda o captura. Verifique instanceof ModelUnavailableError primeiro para distinguir os dois. Leia code para mostrar a sua própria frase, não o message em inglês. MODEL_UNAVAILABLE_CODES, um ReadonlySet<ModelUnavailableCode>, lista os dois códigos. O erro não indica o modelo. O modelo recusado é o provider da sua requisição, ou um dos models dela, em uma requisição que executa vários. Um 403 com insufficient_scope, com qualquer outro código ou sem código continua um ForbiddenError simples.
O construtor é new ModelUnavailableError(code, message?). O construtor de ForbiddenError é new ForbiddenError(message?, missingScope?, code?).
ImportRefusedError
HTTP 403 que recusa uma importação de link, antes que qualquer coisa seja buscada: media.downloadVideo(), uploads.importUrl() e as importações de áudio. Uma medida na conta, a verificação de direitos de conteúdo ou a política de sites da implantação disse não. Veja Direitos de conteúdo e Infratores reincidentes.
code | Recusa |
|---|---|
imports_blocked | A importação de links está bloqueada na conta, ou a conta está encerrada, pela política de infratores reincidentes da implantação. A mensagem diz até quando: uma data em UTC, ou até que um administrador retire o bloqueio. |
import_source_disabled | A implantação não permite importações do site do link. A mensagem não cita nenhum site. |
link_imports_disabled | A implantação desligou as importações de links para outros sites. Um link para outro site é recusado, então envie o arquivo em vez disso. Um arquivo do próprio armazenamento dela não é recusado. |
rights_confirmation_required | A implantação exige uma confirmação, e nenhuma foi enviada. |
rights_authorization_required | A implantação exige uma confirmação, a importação veio por uma chave de API, um app conectado ou um agente de IA, e a conta não tem uma autorização permanente. A pessoa autoriza na própria sessão, com contentRights.authorize(). |
rights_confirmation_not_found | Nenhuma confirmação tem esse ID. |
rights_confirmation_mismatch | A confirmação é de outro link ou de outra conta. |
rights_confirmation_stale | A declaração mudou. Leia de novo e confirme de novo. |
rights_confirmation_expired | A confirmação tem mais de uma hora. |
rights_confirmation_used | Uma importação já foi feita com a confirmação. Uma importação que falhou depois de a busca começar também conta. |
Para um código rights_confirmation_*, chame client.contentRights.confirm({ url, declarationVersion }) de novo e importe de novo com o novo ID. ImportRefusedError estende ForbiddenError, então uma verificação instanceof ForbiddenError que já existe ainda o captura. Verifique instanceof ImportRefusedError primeiro e leia code para mostrar a sua própria frase. IMPORT_REFUSAL_CODES, um ReadonlySet<ImportRefusalCode>, lista os códigos. O construtor é new ImportRefusedError(code, message?).
NotFoundError
HTTP 404. O item não existe ou não está visível para quem chamou. O Nodaro responde da mesma forma nos dois casos, então um ID nunca revela se existe algo que você não pode ver. Um recurso que só existe no Nodaro Cloud, como as produções do Studio ou o Recast, também responde 404 em uma instalação auto-hospedada.
O code é o próprio código do servidor, por exemplo continuation_not_found. Ele é not_found quando o servidor não enviou nenhum código, como em uma rota que não existe. O construtor é new NotFoundError(message?, code?).
Créditos, armazenamento e limites
InsufficientCreditsError
HTTP 402. A conta não consegue pagar a execução, então nada foi iniciado. required é o número de créditos que a execução exige, e available é o número que a conta tem ou, no caso de um limite, o que resta do limite. O Nodaro Cloud preenche os dois, mas o tipo os marca como opcionais. code é o próprio código da recusa: insufficient_credits para o seu próprio saldo e quando o servidor não enviou código, ou outro código 402, como free_video_limit ou insufficient_app_credits.
try {
await client.nodes.runAndWait("generate-video", params)
} catch (err) {
if (err instanceof InsufficientCreditsError) {
console.log(`Need ${err.required} credits, have ${err.available}`)
}
}Leia o saldo antes de uma execução com client.credits.balance(). Veja Créditos.
CreditCapExceededError
HTTP 402 vindo de um limite de gastos que outra pessoa definiu, e não do seu próprio saldo. Uma recarga não resolve: quem definiu o limite precisa aumentá-lo.
code | Limite |
|---|---|
budget_exceeded | O orçamento do espaço de trabalho |
member_cap_exceeded | O seu limite de créditos nesse espaço de trabalho |
user_allowance_exceeded | A cota por usuário da implantação |
CreditCapExceededError estende InsufficientCreditsError, então uma verificação instanceof InsufficientCreditsError existente continua capturando o erro. Verifique instanceof CreditCapExceededError primeiro para diferenciar os dois. CREDIT_CAP_CODES, um ReadonlySet<CreditCapCode>, lista os três códigos.
StorageExceededError
HTTP 413. O que você enviou não cabe. Todo 413 chega como esta classe, seja qual for a rota, e reason diz de que tipo ele é:
reason | Significado |
|---|---|
storage_limit_exceeded | O armazenamento da conta está cheio. limitBytes é o limite. Exclua as mídias de que você não precisa mais e tente de novo. |
file_too_large | Um arquivo passa do limite de tamanho. O armazenamento não está cheio. Envie um arquivo menor. |
payload_too_large, post_too_large, duration_exceeded | A requisição, o post ou a duração da mídia passa de um limite. O armazenamento não está cheio. |
reason é undefined quando a resposta não trouxe código. Uploads e cópias para o seu armazenamento, como um clone da comunidade, lançam esse erro. O construtor é new StorageExceededError(message?, limitBytes?, reason?).
RateLimitedError
HTTP 429. Você enviou requisições demais. Espere e tente de novo com uma pausa crescente: por exemplo, 2 segundos, depois 4, depois 8. Pare depois de algumas tentativas. Veja Limites de taxa.
O code é o próprio código do servidor, por exemplo rate_limit_exceeded, ou rate_limited quando o servidor não enviou nenhum. O construtor é new RateLimitedError(message?, code?).
Espera por tarefas
client.nodes.runAndWait(), client.nodes.runMany() e as funções auxiliares ...AndWait de outros recursos consultam uma tarefa periodicamente até ela terminar. Eles lançam estes erros durante a espera.
JobFailedError
A tarefa terminou com o status failed ou cancelled. jobStatus diz qual dos dois, jobId identifica a tarefa, e message traz a mensagem de erro da própria tarefa. Leia a tarefa completa com client.jobs.get(err.jobId): o error_hint dela explica um bloqueio de segurança ou de política.
JobTimeoutError
A tarefa não chegou a um estado final dentro de maxMs, que por padrão é de 15 minutos. A tarefa não é cancelada. Em geral, ela termina mesmo assim no servidor e vai para a sua biblioteca. Busque a tarefa mais tarde com client.jobs.get(err.jobId) ou passe um maxMs maior para modelos lentos. Uma tarefa que a plataforma está recuperando informa recovering: true no status, e a recuperação pode levar dezenas de minutos.
JobAbortedError
Seu AbortSignal foi acionado. O SDK interrompe a consulta periódica na hora. A tarefa não é cancelada. Para interrompê-la no servidor e reembolsar os créditos reservados, chame client.jobs.cancel(err.jobId).
JobHeldError
A tarefa chegou ao status pending_review: uma política de conteúdo desta implantação reteve o resultado para que uma pessoa o revise. O SDK para de esperar na primeira consulta que vê esse status. A tarefa não é cancelada, e os créditos dela continuam reservados durante a revisão. Não execute a requisição de novo, porque uma duplicata também seria retida.
Verifique a tarefa mais tarde com client.jobs.get(err.jobId). Ela termina em completed quando o revisor a aprova, em failed quando o revisor a rejeita, ou em cancelled se você a cancelar. Uma tarefa rejeitada traz error_hint.kind igual a policy-block e um reason que você pode mostrar como está. Este erro só ocorre em implantações que registram uma política de tarefas.
JobBlockedError
HTTP 422 com o código job_blocked. Uma política de tarefas ou uma proteção de conteúdo desta implantação recusou a requisição antes da execução. Nenhuma tarefa foi criada e nada foi cobrado. message foi escrita para os seus usuários, então mostre-a como está. Não tente a mesma requisição de novo. Este erro só ocorre em implantações que registram uma política de tarefas.
Envios grandes
MediaTooLongError
HTTP 422 com o código media_too_long. uploads.uploadLarge lança este erro quando o envio é concluído: o arquivo tem mais de 30 minutos, o máximo que uma mídia importada para o editor pode ter. A cópia armazenada foi removida, e nada é contado no seu armazenamento. Corte o arquivo e envie de novo. O construtor é new MediaTooLongError(message?).
LargeUploadUnavailableError
O código é large_upload_unavailable. uploads.uploadLarge recebeu um arquivo acima de 500 MB (UPLOAD_MAX_BYTES), e o servidor não oferece caminho de envio grande. status é 409 quando a implantação fechou o caminho, porque ela verifica os bytes de todo envio com uma política de envio, e 404 em um servidor mais antigo que não tem o caminho. POST /v1/upload aceita no máximo 500 MB, então esse servidor não aceita o arquivo. Reduza ou divida o arquivo. O construtor é new LargeUploadUnavailableError(message?, status?).
Alterações simultâneas
WorkflowConflictError
HTTP 409. Você fez uma alteração condicional, e outra pessoa alterou o item antes. Ele chega com um destes dois códigos:
workflow_conflict: umclient.workflows.update()comexpectedVersionouexpectedUpdatedAtnão correspondeu ao workflow armazenado.production_busy: uma produção do Studio continuou mudando enquanto o servidor aplicava a sua alteração, e o servidor parou de tentar.
A solução é a mesma para os dois: leia o item de novo, aplique sua alteração à cópia atualizada e envie de novo. Quando o servidor o inclui, currentRecord contém o workflow atual, então você pode mesclar sem outra leitura.
import { WorkflowConflictError } from "@nodaro/sdk"
try {
await client.workflows.update(id, { settings, expectedVersion: loadedVersion })
} catch (err) {
if (err instanceof WorkflowConflictError && err.currentRecord) {
const merged = mergeSettings(err.currentRecord.settings, settings)
await client.workflows.update(id, { settings: merged, expectedVersion: err.currentVersion })
} else {
throw err
}
}AlreadyRunningError
HTTP 409 com o código already_running. A execução que você pediu para iniciar ou continuar ainda está em andamento, e executionId a indica. Acompanhe essa execução com client.executions.get(executionId) em vez de iniciá-la de novo. client.workflows.run() o lança enquanto uma execução do workflow está em andamento. client.apps.resume() o lança enquanto um Tentar novamente da execução está pendente.
A classe é escolhida quando o 409 traz um executionId. Um 409 que não indica nada continua sendo um NodaroError simples.
AppRunVersionChangedError
HTTP 409 com o código app_run_version_changed. Um Tentar novamente de uma execução de app que falhou, com client.apps.resume(), foi recusado porque o app está em outra versão que não a que a execução executou. Nada foi gravado nem cobrado.
runVersion: a versão que a execução executou.appVersion: a versão em que você está, ou seja, aversionque você enviou, ou então a versão mais recente do app.
Os dois campos são undefined quando a resposta não os traz. Comece a execução de novo com client.apps.run() para executar a versão atual do app. Para continuar na versão da própria execução, chame resume de novo com { version: err.runVersion }.
Locais e objetos usam um código de conflito próprio, concurrent_modification, que chega como um NodaroError simples. Trate-o da mesma forma: leia o item de novo, mescle e tente outra vez.
Lotes do Studio
Estas três classes pertencem às produções do Studio.
StudioOpError: um lote de operações foi recusado, eopIndexé a posição, contada a partir de zero, da operação que causou a recusa. Nada do lote foi gravado. Corrija essa operação e envie o lote inteiro de novo.StudioPreviewUnavailable: você pediu uma prévia comdryRun: true, e esta implantação não consegue gerá-la. Seu lote não foi enviado. Avise o usuário de que a prévia não está disponível e não aplique o lote sem perguntar.StudioPreviewAppliedError: você pediu uma prévia, e o lote foi aplicado mesmo assim. Trateapplied.productioneapplied.versioncomo o estado atual. Não envie o lote de novo. Quandoappliedforundefined, leia a produção de novo antes de decidir qualquer coisa.
Códigos que podem aparecer em NodaroError
Estes códigos chegam em um NodaroError simples. Compare err.code para tratá-los.
| Status | Código | Onde | Significado |
|---|---|---|---|
| 400 | validation_error | Muitos métodos | Um campo está ausente ou é inválido. message indica qual. |
| 400 | no_valid_inputs | client.reduce.run() | Todas as entradas estavam vazias. |
| 400 | invalid_edl | client.edit.applyEdl() | A lista de decisões de edição não passou na validação. |
| 400 | limit_reached | client.developerApps.create() | Você já tem o número máximo de apps. |
| 400 | locked_field | client.apps.run() | Uma substituição tentou alterar um destino, como a URL de um webhook. |
| 409 | name_taken | Personagens, organizações | O nome ou o slug já está em uso. |
| 409 | concurrent_modification | Locais, objetos | O item mudou desde que você o leu. |
| 410 | voice_cloning_retired | client.voices.createClone() | A clonagem de voz não é mais oferecida. Use o design de voz para criar uma voz. |
| 400 | quote_unsupported | client.nodes.quote() | A plataforma não consegue cotar este tipo de nó. A mensagem lista os tipos que ela consegue cotar. |
| 400, 502 | advanced_mode_unavailable | client.llm.structured() | O provedor do próprio modelo não consegue aceitar requisições do Modo avançado agora. Desative o Modo avançado para executar o modelo. |
| 409 | job_cancelled | Requisições de LLM medidas, como client.llm.structured() | A tarefa foi cancelada depois que os créditos foram reservados, mas antes de a chamada ser enviada. Nada é cobrado. Não tente de novo como está: a tarefa foi cancelada de propósito. |
| 503 | job_start_failed | Requisições de LLM medidas | O servidor não conseguiu registrar que a chamada está começando, então não a enviou. Nada é cobrado. Tente de novo. |
| 503 | provider_unavailable | client.llm.structuredJob() | A instância não consegue executar este modelo. Não tente de novo. |
| 503 | feature_disabled | client.copilot | O recurso está desativado nesta implantação. |
| 503 | nodaro_connection_required | client.edit.editPlan() | Uma instalação auto-hospedada precisa de uma conexão com o Nodaro Cloud para isso. |
Cada página de referência lista os códigos dos próprios métodos. A página Erros da API REST lista todos os códigos que a API pode enviar.
Tentar de novo com segurança
- Repita leituras à vontade. Um
getou umlistnão tem efeitos colaterais. - Não repita às cegas uma requisição paga. Uma requisição que excedeu o tempo limite pode ter iniciado uma execução mesmo assim. Antes de repetir uma geração, passe uma chave de idempotência:
client.nodes.run(type, params, { idempotencyKey })erunAndWaitaceitam uma. Reutilize a mesma chave ao repetir a mesma requisição, e a plataforma retorna a primeira execução em vez de iniciar e cobrar uma segunda. - Studio e Recast usam tokens de nova tentativa próprios:
clientRequestIdnos métodos do Studio erequestIdemclient.recast.rescore(). - Repita respostas 5xx com uma pausa. Um
fetchpersonalizado emcreateClienté um bom lugar para essa lógica.
throwFromResponse(status, body)
throwFromResponse(status: number, body: {
error?: { code?: string; message?: string; [key: string]: unknown }
}): neverConverte um status HTTP e um corpo de erro do Nodaro na classe de erro correspondente e a lança. O SDK usa essa função em todas as respostas, e ela é exportada para transportes personalizados que chamam a API sem o cliente.
Propriedade
Tipo
import { throwFromResponse } from "@nodaro/sdk"
throwFromResponse(403, {
error: { code: "insufficient_scope", message: "Missing scope", missingScope: "workflows:execute" },
})
// throws a ForbiddenError whose missingScope is "workflows:execute"A maioria das rotas responde com o envelope { error: { code, message } }. Algumas rotas mais antigas respondem com outros formatos, e o SDK também os lê, então os erros delas trazem um code e uma message reais:
| Corpo | code | message |
|---|---|---|
{ error: "<code>", message? }, por exemplo do treinamento de personagem | A string | message, ou o código quando não há mensagem |
{ error: "<code>", error_description }, do OAuth | A string | error_description |
{ message, issues: [...] }, uma resposta de validação com HTTP 400 | validation_error | message |
{ statusCode, error: "<reason phrase>", message }, por exemplo uma rota que o servidor não tem | internal_error | message |
Com HTTP 500 ou acima, o SDK lê desses formatos apenas o código, nunca o texto. A message de um erro assim é o código dele, ou “Request failed”. A message do próprio envelope é lida em qualquer status.
A classe do erro continua seguindo o status: um 404 é um NotFoundError, diga o corpo o que disser. Um corpo sem texto legível mantém a mensagem padrão da classe, como “Not found”. Um InsufficientCreditsError lê required e available do envelope, ou os campos required e balance que o servidor envia ao lado dele. Em uma cota por usuário, available lê remaining.
Perguntas frequentes
Como capturar erros da API do Nodaro em TypeScript?
Envolva a chamada em try/catch e teste o erro com instanceof, da classe mais específica até NodaroError, por último. Todas as classes são exportadas por @nodaro/sdk.
O que acontece quando a conta não tem créditos suficientes?
A chamada lança InsufficientCreditsError com status HTTP 402 antes de qualquer trabalho começar. Os campos required e available informam quantos créditos a execução exige e quantos a conta tem.
JobTimeoutError cancela a tarefa?
Não. A tarefa continua em execução e, em geral, termina mesmo assim. Busque a tarefa mais tarde com client.jobs.get(jobId) ou aumente maxMs para modelos lentos.
Devo tentar de novo depois de um RateLimitedError?
Sim, depois de uma pausa. Espere alguns segundos, dobre a espera a cada novo 429 e pare depois de algumas tentativas.
Qual código um ForbiddenError traz?
O próprio código do servidor, por exemplo insufficient_scope ou node_not_available, para você decidir o que fazer a partir dele. O código é forbidden só quando o servidor não enviou nenhum. Um modelo recusado chega como ModelUnavailableError, e uma importação de link recusada como ImportRefusedError.
Páginas relacionadas
SDK para TypeScript
Tarefas e execuções
Executar nós
Erros
Limites de taxa
Última atualização
Autenticação
Escolha como o SDK do Nodaro se autentica, com StaticTokenAuth, CallbackAuth ou supabaseAuth, e compartilhe um login do navegador entre seus subdomínios.
Workflows e projetos
Crie, atualize, compartilhe, exporte, importe e execute workflows do Nodaro em TypeScript com client.workflows e agrupe-os em projetos com client.projects.