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

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

ClasseStatuscodeCampos extrasQuando é lançado
NodaroErrorQualquer umO código do servidorA classe base, e qualquer erro sem uma classe mais específica
UnauthorizedError401unauthorizedO token está ausente, expirou ou é inválido
ForbiddenError403O código do servidor, ou forbiddenmissingScope?A permissão foi negada, ou falta um escopo a um token OAuth
ModelUnavailableError403model_not_available ou model_disabledO modelo que você escolheu não é oferecido, ou um administrador o desativou
ImportRefusedError403imports_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
NotFoundError404O código do servidor, ou not_foundO item não existe, ou você não pode vê-lo
RateLimitedError429O código do servidor, ou rate_limitedRequisições demais
InsufficientCreditsError402insufficient_credits, ou outro código 402required?, available?A conta não consegue pagar a execução
CreditCapExceededError402budget_exceeded, member_cap_exceeded ou user_allowance_exceededrequired?, available?Um limite de gastos que outra pessoa definiu recusou a execução
StorageExceededError413storage_exceededlimitBytes?, reason?O que você enviou não cabe: um armazenamento cheio, ou um arquivo acima do limite
WorkflowConflictError409workflow_conflict ou production_busycurrentUpdatedAt?, currentVersion?, currentRecord?Outra pessoa alterou o item antes
AlreadyRunningError409already_runningexecutionIdA execução que você pediu para iniciar ou continuar ainda está em andamento
AppRunVersionChangedError409app_run_version_changedrunVersion?, appVersion?O Tentar novamente de uma execução de app foi recusado porque o app mudou de versão
JobBlockedError422job_blockedA política de conteúdo da implantação recusou a requisição
MediaTooLongError422media_too_longUm envio grande tem mais de 30 minutos
LargeUploadUnavailableError409 ou 404large_upload_unavailableUm arquivo acima de 500 MB, em um servidor sem caminho de envio grande
StudioOpError4xxO código do servidoropIndexUma operação de um lote do Studio foi recusada
JobFailedError0job_failedjobId, jobStatusUma tarefa que você estava esperando falhou ou foi cancelada
JobTimeoutError0job_timeoutjobId, timeoutMsUma tarefa não terminou dentro de maxMs
JobAbortedError0job_abortedjobId?Seu AbortSignal foi acionado durante a espera
JobHeldError0job_heldjobIdUma tarefa está retida para revisão humana
StudioPreviewUnavailable0studio_preview_unavailableA implantação não consegue gerar a prévia de um lote do Studio
StudioPreviewAppliedError0studio_preview_appliedappliedUm 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.

codeRecusa
model_not_availableEsta 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_disabledUm 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.

codeRecusa
imports_blockedA 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_disabledA implantação não permite importações do site do link. A mensagem não cita nenhum site.
link_imports_disabledA 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_requiredA implantação exige uma confirmação, e nenhuma foi enviada.
rights_authorization_requiredA 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_foundNenhuma confirmação tem esse ID.
rights_confirmation_mismatchA confirmação é de outro link ou de outra conta.
rights_confirmation_staleA declaração mudou. Leia de novo e confirme de novo.
rights_confirmation_expiredA confirmação tem mais de uma hora.
rights_confirmation_usedUma 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.

codeLimite
budget_exceededO orçamento do espaço de trabalho
member_cap_exceededO seu limite de créditos nesse espaço de trabalho
user_allowance_exceededA 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 é:

reasonSignificado
storage_limit_exceededO 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_largeUm arquivo passa do limite de tamanho. O armazenamento não está cheio. Envie um arquivo menor.
payload_too_large, post_too_large, duration_exceededA 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: um client.workflows.update() com expectedVersion ou expectedUpdatedAt nã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, a version que 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, e opIndex é 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 com dryRun: 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. Trate applied.production e applied.version como o estado atual. Não envie o lote de novo. Quando applied for undefined, 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.

StatusCódigoOndeSignificado
400validation_errorMuitos métodosUm campo está ausente ou é inválido. message indica qual.
400no_valid_inputsclient.reduce.run()Todas as entradas estavam vazias.
400invalid_edlclient.edit.applyEdl()A lista de decisões de edição não passou na validação.
400limit_reachedclient.developerApps.create()Você já tem o número máximo de apps.
400locked_fieldclient.apps.run()Uma substituição tentou alterar um destino, como a URL de um webhook.
409name_takenPersonagens, organizaçõesO nome ou o slug já está em uso.
409concurrent_modificationLocais, objetosO item mudou desde que você o leu.
410voice_cloning_retiredclient.voices.createClone()A clonagem de voz não é mais oferecida. Use o design de voz para criar uma voz.
400quote_unsupportedclient.nodes.quote()A plataforma não consegue cotar este tipo de nó. A mensagem lista os tipos que ela consegue cotar.
400, 502advanced_mode_unavailableclient.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.
409job_cancelledRequisiçõ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.
503job_start_failedRequisições de LLM medidasO servidor não conseguiu registrar que a chamada está começando, então não a enviou. Nada é cobrado. Tente de novo.
503provider_unavailableclient.llm.structuredJob()A instância não consegue executar este modelo. Não tente de novo.
503feature_disabledclient.copilotO recurso está desativado nesta implantação.
503nodaro_connection_requiredclient.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 get ou um list nã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 }) e runAndWait aceitam 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: clientRequestId nos métodos do Studio e requestId em client.recast.rescore().
  • Repita respostas 5xx com uma pausa. Um fetch personalizado em createClient é um bom lugar para essa lógica.

throwFromResponse(status, body)

throwFromResponse(status: number, body: {
  error?: { code?: string; message?: string; [key: string]: unknown }
}): never

Converte 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:

Corpocodemessage
{ error: "<code>", message? }, por exemplo do treinamento de personagemA stringmessage, ou o código quando não há mensagem
{ error: "<code>", error_description }, do OAuthA stringerror_description
{ message, issues: [...] }, uma resposta de validação com HTTP 400validation_errormessage
{ statusCode, error: "<reason phrase>", message }, por exemplo uma rota que o servidor não teminternal_errormessage

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.

Última atualização

Nesta página