Tipos
Todos os tipos TypeScript, funções auxiliares e constantes que o @nodaro/sdk exporta, agrupados por recurso, com a página que documenta cada um.
@nodaro/sdk exporta um tipo TypeScript para as entradas e as saídas da maioria dos métodos, além de algumas funções auxiliares e constantes. Importe os tipos com import type, para que eles não acrescentem nada ao seu bundle:
import type { Workflow, Job, NodeJobOutput, WorkflowExecution } from "@nodaro/sdk"
const { data }: { data: Workflow } = await client.workflows.get(id)Os tipos seguem o formato de transmissão da API. Um Job usa campos em snake_case, como output_data e created_at, porque a API os envia assim. Um Workflow e um WorkflowExecution usam camelCase. Object, o tipo de objeto, tem o mesmo nome do objeto global do JavaScript, então importe-o com outro nome quando precisar dos dois: import type { Object as NodaroObject } from "@nodaro/sdk".
Alguns tipos que os métodos usam não são exportados. Um tipo definido em @nodaro/shared, como PipelineInput ou CommunityFullDetail, é importado de lá. Adicione @nodaro/shared às suas próprias dependências, na faixa de versões que o SDK usa, para que só uma cópia seja instalada. Derive qualquer outro tipo, como PipelineRecord, do método que o retorna:
import type { NodaroClient } from "@nodaro/sdk"
import type { PipelineInput, CommunityFullDetail } from "@nodaro/shared"
type PipelineRecord = Awaited<ReturnType<NodaroClient["pipelines"]["get"]>>Cliente, autenticação e erros
| Exportação | Tipo | Documentado em |
|---|---|---|
createClient, NodaroClient | Função, classe | Cliente |
ClientOptions, UserIdentity, MeOrganizations | Tipos | Cliente |
Auth, StaticTokenAuth, CallbackAuth, supabaseAuth | Tipo, classes, função | Autenticação |
createSharedSupabaseClient | Função, de @nodaro/sdk/supabase | Autenticação |
NodaroError, UnauthorizedError, ForbiddenError, NotFoundError, RateLimitedError, InsufficientCreditsError, StorageExceededError, WorkflowConflictError, JobBlockedError, JobFailedError, JobTimeoutError, JobAbortedError, JobHeldError, StudioOpError, StudioPreviewUnavailable, StudioPreviewAppliedError | Classes | Erros |
WorkflowConflictCode, throwFromResponse | Tipo, função | Erros |
Workflows, execuções e nós
| Exportação | Documentado em |
|---|---|
Workflow, ListWorkflowsParams, CreateWorkflowInput, UpdateWorkflowInput, RunWorkflowParams, RunWorkflowResult | Workflows e projetos |
Project, CreateProjectInput, UpdateProjectInput | Workflows e projetos |
GenericNode, GenericEdge, WorkflowExport, WorkflowExportCharacter, WorkflowExportObject, WorkflowExportLocation | Workflows e projetos |
Job, JobStatus, JobStatusResult, JobErrorHint, SafetyBlockHint, PolicyBlockHint, CreditStatus, CancelJobResult, DeleteJobResult, ListJobsParams, ListJobsPage | Jobs e execuções |
WorkflowExecution, WorkflowExecutionSummary, NodeExecutionState, NodeExecutionStatus, ExecutionStatus, ExecutionTriggerType, ListExecutionsForWorkflowParams, ListExecutionsPage, CancelExecutionParams | Jobs e execuções |
StopVideoProResult, ContinueVideoProResult | Jobs e execuções |
NodeDescriptor, NodeCategory, OutputType, NodeInputField, NodeInputSchema | Executar nós |
RunNodeResult, RunNodeAdjustment, NodeJobOutput, RunAndWaitOptions, RunManyResult | Executar nós |
GenerateImageParams, GenerateVideoParams, TextToVideoParams, StructuredReferenceParams, ConnectedReference, DescribedReference | Executar nós |
PromptAffixFields | Os campos de dados do nó para o texto antes e depois do prompt: promptPrefix e promptSuffix |
PublishedApp, PublishedAppDetail, ListAppsParams, ListAppsResult, AppRunResult, RunAppOptions, AppRun, ListAppRunsParams, DeleteAppRunResult | Apps e templates |
Template, TemplateBrowseCard, TemplateSort, BrowseTemplatesParams, BrowseTemplatesResult, CloneTemplateParams, CloneTemplateResult | Apps e templates |
TutorialCategory, TutorialVideoItem, TutorialFlowItem | Apps e templates |
LlmStructuredInput, LlmStructuredResult, LlmStructuredJobInput, LlmStructuredJobOutput | LLM e Reduce |
ReduceStrategyId, ReduceMeta, ReduceInput, ReduceResult | LLM e Reduce |
Mídia, vozes e edição
| Exportação | Documentado em |
|---|---|
UploadResult, LibraryAsset, ListLibraryParams, ListLibraryResult | Mídia e uploads |
VideoMetadata, DownloadVideoProgress, MediaProcessInput, MediaProcessResult, OverlayPlacement | Mídia e uploads |
AddCaptionsInput, CaptionLookInput, CaptionSegmentInput, CaptionEntry | Mídia e uploads |
Voice, SharedVoice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse | Vozes e áudio |
VoiceChangerProInput, VoiceChangerProVoice, VcpAnalyzeInput, VcpAnalysis, VcpAnalysisSpeaker, VcpExportInput, VcpExportTrack | Vozes e áudio |
VoiceDesignInput, VoiceRemixInput, DubbingInput, AudioFxPreset | Vozes e áudio |
TranscribeWord, TranscribeJobOutput, TranscribeProvider, TranscribeLane | Vozes e áudio |
EditJobResult, SilenceDetectInput, SilenceRanges, AudioSyncInput, AudioSyncSource, AudioSyncOffset, AudioSyncResult, ApplyEdlInput, EditPlanInput, EditPlanSource, EditPlanMode, EditPlanTier, Edl, EdlClipSet, ChapterSet, Transcript | Edição |
GenerateScene3DParams, EditScene3DParams, RenderScene3DParams, Scene3DJobOutput, Scene3DCapabilities, Scene3DAuthoringEngine, RetainedScene3DEditParams, RetainedScene3DEditResult, Scene3DDelivery, Scene3DDeliveryAsset, Scene3DDeliveryAssetKind | Cenas 3D |
Entidades
| Exportação | Documentado em |
|---|---|
Character, CharacterDetail, CharacterUsage, ReferencePhoto, ReferencePhotoKind, UpsertCharacterInput, UpsertCharacterResult, ListCharactersParams, ListCharactersResult, DuplicateCharacterInput, GenerateCharacterInput, GenerateCharacterResult, GenerateAssetInput, GenerateMotionInput, ApprovePortraitResult, RecaptionResult, CharacterAspectRatio, EntityStyle | Personagens |
Location, LocationDetail, LocationReferencePhoto, LocationReferencePhotoKind, CreateLocationInput, UpdateLocationInput, UpdateLocationResult, ListLocationsParams, GenerateLocationInput, GenerateLocationResult, GenerateLocationAssetInput, GenerateSurroundContinuationInput, ApproveMainImageResult, RecaptionLocationResult, LocationAssetType, LocationAttachColumn, SurroundDirection | Locais |
Object, ObjectDetail, ObjectCategory, ObjectReferencePhoto, ObjectReferencePhotoKind, CreateObjectInput, UpdateObjectInput, UpdateObjectResult, UpsertObjectInput, UpsertObjectResult, ListObjectsParams, GenerateObjectInput, GenerateObjectResult, GenerateObjectAssetInput, GenerateObjectAssetResult, GenerateObjectMotionInput, GenerateObjectMotionResult, ApproveObjectMainImageResult, RecaptionObjectResult, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio | Objetos e criaturas |
Creature, CreatureDetail, CreatureReferencePhoto, CreatureReferencePhotoKind, CreateCreatureInput, UpdateCreatureInput, UpdateCreatureResult, UpsertCreatureInput, UpsertCreatureResult, ListCreaturesParams, GenerateCreatureInput, GenerateCreatureResult, GenerateCreatureAssetInput, GenerateCreatureAssetResult, GenerateCreatureMotionInput, GenerateCreatureMotionResult, ApproveCreatureMainImageResult, RecaptionCreatureResult, CreatureAssetType, CreatureAttachColumn, CreatureAspectRatio | Objetos e criaturas |
CommunityCard, CommunityEntityType, CommunitySort, CommunityReportReason, BrowseCommunityParams, BrowseCommunityResult, CloneListingResult, FavoriteListingResult, ReportListingResult | Biblioteca da comunidade |
Produções
| Exportação | Documentado em |
|---|---|
StudioProduction, StudioProductionDetail, StudioSkillResponse, StudioValidatePlanResponse, StudioPlanIssue, StudioListProductionsResponse, ListStudioProductionsOptions, GetProductionOptions, StudioExportPlanOptions, StudioExportPlanResponse, StudioExportStep | Produções do Studio |
StudioCreateProductionRequest, StudioProductionResponse, StudioImportSummary, StudioClientRequestId, StudioOpsRequest, StudioOpsResponse, StudioOpsReceipt, StudioOpsImpact, StudioOpClass, StudioOpsDryRunReceipt, StudioOpsDryRunResponse, StudioReconcileResponse | Produções do Studio |
StudioGenerateRequest, StudioGenerateOptions, StudioGenerateResult, StudioGenerateEstimate, StudioGenerateResponse, StudioVideoLane, StudioDescribeRequest, StudioFrameRequest, StudioVoiceRequest, StudioRevoiceRequest, StudioMusicRequest, StudioMediaResponse, StudioJobStartedResponse, StudioCloneRequest | Produções do Studio |
StudioProductionCapabilities, StudioKeyframeRecord, StudioProductionRecord, StudioProductionReply, StudioEditInput, StudioKeyframeGenerationInput, StudioKeyframeAcceptanceInput, StudioShotGenerationInput, StudioGenerationReply, StudioDocumentJson | Produções do Studio |
Shot, ShotMode, ShotEntityRef, CreateShotInput, UpdateShotInput | Produções do Studio |
CreateRecastInput, EstimateRecastInput, RecastEstimate, RecastRunSnapshot, ResolveRecastGateInput, RecastScriptValidation, RecastScriptValidationError, RecastScriptImportResult | Recast |
RecastAudioManifestV1, RecastAudioLayerName, RecastAudioMix, RecastAudioMixControl, RecastAudioSectionReplacement, RecastRescoreReplacement, RecastRescoreOperation, EstimateRecastRescoreInput, RecastRescoreRequestV2, RecastRescoreQuote, RecastRescoreResponse | Recast |
PipelineStageName, BranchPipelineInput, BranchPipelineResult, ChatTurn, ChatStageResult, ApplyChatProposalResult | Pipelines |
CopilotThread, CopilotThreadWorkflow, CopilotSurface, CopilotRunMode, CopilotModelTier, CopilotMessage, CopilotMessagePart, CreateCopilotThreadInput, CopilotStreamOptions, CopilotStreamFrame e os tipos de dados dos frames | Copilot |
Conta e catálogos
| Exportação | Documentado em |
|---|---|
ModelSummary, ModelsListResult, ListModelsOptions, UserBalance, ModelCostsResult | Modelos e créditos |
PickerCatalog, PickerCatalogSummary, PickerOption, PickerDimension, PickerCatalogSection, GetPickerCatalogOptions | Seletores, predefinições e prompts |
CatalogsListResponse, ProjectedCatalog, ProjectedCatalogOption, ProjectedCatalogDimension, ProjectedCatalogSection | Seletores, predefinições e prompts |
NodePreset, NodePresetGroup, FactoryPresetsResult | Seletores, predefinições e prompts |
AnalyzeInput, AnalyzeResult, GenerateInput, EnhanceInput, PromptResult, WizardQuestion, WizardOption, WizardSelection, RecommendedModel, WizardNodeContext | Seletores, predefinições e prompts |
OrganizationView, OrganizationSummary, OrgMemberView, OrgKind, OrgRole, OrgStatus, OrgSettings, OrgAuditEntry, OrgPage, OrgErrorCode, MemberStatus, CreateOrgInput, InviteInput, ListInvitationsOptions | Organizações e espaços de trabalho |
InvitationView, InvitationDelivery, InvitationPreview, InvitationState, JoinCodeView | Organizações e espaços de trabalho |
WorkspaceView, WorkspaceSummary, WorkspaceMemberView, WorkspaceRole, WorkspaceSettings, CreateWorkspaceInput | Organizações e espaços de trabalho |
UsageQuery, UsageGroupBy, UsageReport, UsageReportRow, UsageReportTotals, UsageVarianceRow, UsageLogEntry | Organizações e espaços de trabalho |
DeveloperApp, DeveloperAppScope, DeveloperAppStatus, DeveloperAppKind, CreateDeveloperAppInput, UpdateDeveloperAppInput, CreateDeveloperAppResult, RotateSecretResult | OAuth e apps de desenvolvedor |
ExchangeCodeInput, AccessTokenResponse, OAuthAppInfo | OAuth e apps de desenvolvedor |
Funções auxiliares e constantes
Estes são valores, não tipos, então importe-os sem type.
| Exportação | O que é |
|---|---|
nodeStateMayCarryOutput(status), OUTPUT_BEARING_NODE_STATUSES | Se o estado de um nó pode trazer output: completed e failed. Veja Jobs e execuções. |
isStudioGenerateEstimate(result) | Distingue uma cotação de geração de uma execução iniciada. Veja Produções do Studio. |
unwrapEditPlanOutput(outputData) | Lê a saída de um job de plano de edição como uma EDL, uma lista de EDLs ou capítulos. Veja Edição. |
throwFromResponse(status, body) | Lança a classe de erro que corresponde a uma resposta da API. Veja Erros. |
PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY | As chaves de dados do nó do texto antes e depois do prompt. |
WORKSPACE_HEADER | O nome do cabeçalho de espaço de trabalho, X-Nodaro-Workspace. |
USAGE_GROUP_BYS | Os agrupamentos que um relatório de uso aceita. |
LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, SURROUND_DIRECTIONS | Os tipos de variação, as coleções e as direções das vistas em 360 graus permitidos para locais. |
OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, OBJECT_ASPECT_OPTIONS, OBJECT_ASPECT_DEFAULTS | Os tipos de variação, as coleções e as proporções permitidos para objetos. |
CREATURE_ASSET_TYPES, CREATURE_ATTACH_COLUMNS, CREATURE_ASPECT_OPTIONS, CREATURE_ASPECT_DEFAULTS | As mesmas listas para criaturas. |
CHARACTER_STYLES, CHARACTER_ASPECT_OPTIONS, CHARACTER_ASPECT_DEFAULTS | Os estilos e as proporções de personagens. |
SCENE3D_DELIVERY_ASSET_USAGE | Os pares permitidos de tipo de arquivo de entrega e uso. |
Toda classe de recurso, como WorkflowsResource ou NodesResource, também é exportada, para tipagem avançada. Você raramente precisa delas: createClient monta todos os recursos para você.
Perguntas frequentes
Páginas relacionadas
SDK para TypeScript
Cliente
Erros
Executar nós
Última atualização
OAuth e apps de desenvolvedor
Registre e gerencie apps OAuth do Nodaro com client.developerApps, e troque códigos, revogue tokens e leia dados da tela de consentimento com client.oauth.
CLI
Instale a CLI do Nodaro pelo npm ou como binário, faça login uma vez por instância e execute workflows, apps e nós avulsos no terminal ou em um job de CI.