Nodaro 문서
문서노드 레퍼런스모델템플릿AI 에이전트(MCP)개발자셀프 호스팅리서치비교
TypeScript SDK

타입

@nodaro/sdk가 내보내는 모든 TypeScript 타입, 헬퍼 함수, 상수를 리소스별로 묶고, 각각을 설명하는 페이지와 함께 안내합니다.

@nodaro/sdk는 대부분의 메서드 입력과 출력에 대한 TypeScript 타입과 함께, 몇 가지 헬퍼 함수와 상수를 내보냅니다. 타입은 import type으로 가져오세요. 그러면 번들에 아무것도 추가되지 않습니다.

import type { Workflow, Job, NodeJobOutput, WorkflowExecution } from "@nodaro/sdk"

const { data }: { data: Workflow } = await client.workflows.get(id)

타입은 API의 전송 형식을 따릅니다. Job은 API가 그렇게 보내기 때문에 output_data, created_at 같은 snake_case 필드를 씁니다. Workflow와 WorkflowExecution은 camelCase를 씁니다. 오브젝트 타입인 Object는 JavaScript 전역 객체와 이름이 같으므로, 둘 다 필요할 때는 다른 이름으로 가져오세요: import type { Object as NodaroObject } from "@nodaro/sdk".

메서드가 쓰는 타입 중 일부는 내보내지 않습니다. PipelineInput이나 CommunityFullDetail처럼 @nodaro/shared에 정의된 타입은 그곳에서 가져옵니다. @nodaro/shared를 SDK가 쓰는 버전 범위로 내 의존성에 추가하면 사본이 하나만 설치됩니다. PipelineRecord 같은 그 밖의 타입은 그 타입을 반환하는 메서드에서 도출하세요.

import type { NodaroClient } from "@nodaro/sdk"
import type { PipelineInput, CommunityFullDetail } from "@nodaro/shared"

type PipelineRecord = Awaited<ReturnType<NodaroClient["pipelines"]["get"]>>

클라이언트, 인증, 오류

내보내는 항목종류설명 페이지
createClient, NodaroClient함수, 클래스클라이언트
ClientOptions, UserIdentity, MeOrganizations, ConnectedApp타입클라이언트
Auth, StaticTokenAuth, CallbackAuth, supabaseAuth타입, 클래스, 함수인증
createSharedSupabaseClient함수, @nodaro/sdk/supabase에서 제공인증
NodaroError, UnauthorizedError, ForbiddenError, NotFoundError, RateLimitedError, InsufficientCreditsError, StorageExceededError, WorkflowConflictError, JobBlockedError, JobFailedError, JobTimeoutError, JobAbortedError, JobHeldError, StudioOpError, StudioPreviewUnavailable, StudioPreviewAppliedError클래스오류
WorkflowConflictCode, throwFromResponse타입, 함수오류

워크플로, 실행, 노드

내보내는 항목설명 페이지
Workflow, ListWorkflowsParams, CreateWorkflowInput, UpdateWorkflowInput, RunWorkflowParams, RunWorkflowResult, RenderFinalParams, RenderFinalQuote워크플로와 프로젝트
Project, CreateProjectInput, UpdateProjectInput워크플로와 프로젝트
GenerationSession, SessionItem, SessionPage, CreateSessionInput, UpdateSessionInput, ListSessionsParams, ListSessionItemsParams, GenerationSessionParams워크플로와 프로젝트
GenericNode, GenericEdge, WorkflowExport, WorkflowExportCharacter, WorkflowExportObject, WorkflowExportLocation워크플로와 프로젝트
Job, JobStatus, JobStatusResult, JobErrorHint, SafetyBlockHint, PolicyBlockHint, CreditStatus, CancelJobResult, DeleteJobResult, ListJobsParams, ListJobsPage, JobRating, JobRatingFilter, RateJobResult작업과 실행
WebhookEndpoint, CreateWebhookEndpointInput, UpdateWebhookEndpointInput, CreatedWebhookEndpoint, RotateWebhookSecretInput, RotatedWebhookSecret, WebhookDelivery, WebhookDeliveryPage, ListWebhookDeliveriesParams, WebhookJobEvent, WebhookEventType, WebhookDeliveryStatus, WebhookEvent, JobWebhookEvent, PingWebhookEvent, WebhookSignatureError, VerifyWebhookSignatureOptions, WebhookSignatureErrorCode작업과 실행
WorkflowExecution, WorkflowExecutionSummary, NodeExecutionState, NodeExecutionStatus, ExecutionStatus, ExecutionOutcome, ExecutionTriggerType, ListExecutionsForWorkflowParams, ListExecutionsPage, CancelExecutionParams작업과 실행
StopVideoProResult, ContinueVideoProResult작업과 실행
NodeDescriptor, NodeCategory, OutputType, NodeInputField, NodeInputSchema노드 실행
RunNodeResult, RunNodeAdjustment, RunNodeWarning, NodeJobOutput, JobOutputImage, RunAndWaitOptions, RunManyResult, GenerateImageBatchResult, GenerateImageBatchOutput, BatchJobOutcome노드 실행
GenerateImageParams, GenerateVideoParams, TextToVideoParams, StructuredReferenceParams, ConnectedReference, DescribedReference노드 실행
PromptAffixFields앞뒤 텍스트의 노드 데이터 필드: promptPrefix와 promptSuffix
PublishedApp, PublishedAppDetail, ListAppsParams, ListAppsResult, AppRunResult, RunAppOptions, AppRun, ListAppRunsParams, DeleteAppRunResult앱과 템플릿
Template, TemplateBrowseCard, TemplateSort, BrowseTemplatesParams, BrowseTemplatesResult, CloneTemplateParams, CloneTemplateResult앱과 템플릿
TutorialCategory, TutorialVideoItem, TutorialFlowItem앱과 템플릿
LlmStructuredInput, LlmStructuredResult, LlmStructuredJobInput, LlmStructuredJobOutputLLM과 Reduce
ReduceStrategyId, ReduceMeta, ReduceInput, ReduceResultLLM과 Reduce

미디어, 보이스, 편집

내보내는 항목설명 페이지
UploadResult, LibraryAsset, ListLibraryParams, ListLibraryResult미디어와 업로드
GalleryItem, GalleryMediaType, BrowseGalleryParams, GalleryPage, ToggleFavoriteResult미디어와 업로드
VideoMetadata, DownloadVideoProgress, MediaProcessInput, MediaProcessResult, OverlayPlacement미디어와 업로드
AddCaptionsInput, CaptionLookInput, CaptionSegmentInput, CaptionEntry미디어와 업로드
Voice, SharedVoice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse보이스와 오디오
VoiceChangerProInput, VoiceChangerProVoice, VcpAnalyzeInput, VcpAnalysis, VcpAnalysisSpeaker, VcpExportInput, VcpExportTrack보이스와 오디오
VoiceDesignInput, VoiceRemixInput, DubbingInput, AudioFxPreset보이스와 오디오
TranscribeWord, TranscribeJobOutput, TranscribeProvider, TranscribeLane보이스와 오디오
EditJobResult, SilenceDetectInput, SilenceRanges, AudioSyncInput, AudioSyncSource, AudioSyncOffset, AudioSyncResult, ApplyEdlInput, EditPlanInput, EditPlanSource, EditPlanMode, EditPlanTier, Edl, EdlClipSet, ChapterSet, Transcript, TightenEpisodeInput, TightenEpisodeJobResult, TightenEpisodeEstimate, UseCaseContinueInput편집
GenerateScene3DParams, EditScene3DParams, RenderScene3DParams, Scene3DJobOutput, Scene3DCapabilities, Scene3DAuthoringEngine, RetainedScene3DEditParams, RetainedScene3DEditResult, Scene3DDelivery, Scene3DDeliveryAsset, Scene3DDeliveryAssetKind3D 장면

에셋

내보내는 항목설명 페이지
Character, CharacterDetail, CharacterUsage, ReferencePhoto, ReferencePhotoKind, UpsertCharacterInput, UpsertCharacterResult, ListCharactersParams, ListCharactersResult, DuplicateCharacterInput, GenerateCharacterInput, GenerateCharacterResult, GenerateAssetInput, GenerateMotionInput, ApprovePortraitResult, RecaptionResult, CharacterAspectRatio, EntityStyle, TrainCharacterInput, TrainCharacterResult, CharacterTrainingStatus, CharacterTrainingState, TrainCharacterRefusalCode캐릭터
Location, LocationDetail, LocationReferencePhoto, LocationReferencePhotoKind, CreateLocationInput, UpdateLocationInput, UpdateLocationResult, ListLocationsParams, GenerateLocationInput, GenerateLocationResult, GenerateLocationAssetInput, GenerateSurroundContinuationInput, ApproveMainImageResult, RecaptionLocationResult, LocationAssetType, LocationAttachColumn, SurroundDirection장소
Object, ObjectDetail, ObjectCategory, ObjectReferencePhoto, ObjectReferencePhotoKind, CreateObjectInput, UpdateObjectInput, UpdateObjectResult, UpsertObjectInput, UpsertObjectResult, ListObjectsParams, GenerateObjectInput, GenerateObjectResult, GenerateObjectAssetInput, GenerateObjectAssetResult, GenerateObjectMotionInput, GenerateObjectMotionResult, ApproveObjectMainImageResult, RecaptionObjectResult, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio오브젝트와 크리처
Creature, CreatureDetail, CreatureReferencePhoto, CreatureReferencePhotoKind, CreateCreatureInput, UpdateCreatureInput, UpdateCreatureResult, UpsertCreatureInput, UpsertCreatureResult, ListCreaturesParams, GenerateCreatureInput, GenerateCreatureResult, GenerateCreatureAssetInput, GenerateCreatureAssetResult, GenerateCreatureMotionInput, GenerateCreatureMotionResult, ApproveCreatureMainImageResult, RecaptionCreatureResult, CreatureAssetType, CreatureAttachColumn, CreatureAspectRatio오브젝트와 크리처
CommunityCard, CommunityEntityType, CommunitySort, CommunityReportReason, BrowseCommunityParams, BrowseCommunityResult, CloneListingResult, FavoriteListingResult, ReportListingResult커뮤니티 라이브러리

프로덕션

내보내는 항목설명 페이지
StudioProduction, StudioProductionDetail, StudioSkillResponse, StudioValidatePlanResponse, StudioPlanIssue, StudioListProductionsResponse, ListStudioProductionsOptions, GetProductionOptions, StudioExportPlanOptions, StudioExportPlanResponse, StudioExportStep스튜디오 프로덕션
StudioCreateProductionRequest, StudioProductionResponse, StudioImportSummary, StudioClientRequestId, StudioOpsRequest, StudioOpsResponse, StudioOpsReceipt, StudioOpsImpact, StudioOpClass, StudioOpsDryRunReceipt, StudioOpsDryRunResponse, StudioReconcileResponse스튜디오 프로덕션
StudioGenerateRequest, StudioGenerateOptions, StudioGenerateResult, StudioGenerateEstimate, StudioGenerateResponse, StudioVideoLane, StudioDescribeRequest, StudioFrameRequest, StudioVoiceRequest, StudioRevoiceRequest, StudioMusicRequest, StudioMediaResponse, StudioJobStartedResponse, StudioCloneRequest스튜디오 프로덕션
StudioProductionCapabilities, StudioKeyframeRecord, StudioProductionRecord, StudioProductionReply, StudioEditInput, StudioKeyframeGenerationInput, StudioKeyframeAcceptanceInput, StudioShotGenerationInput, StudioGenerationReply, StudioDocumentJson스튜디오 프로덕션
Shot, ShotMode, ShotEntityRef, CreateShotInput, UpdateShotInput스튜디오 프로덕션
CreateRecastInput, EstimateRecastInput, RecastEstimate, RecastRunSnapshot, ResolveRecastGateInput, RecastScriptValidation, RecastScriptValidationError, RecastScriptImportResultRecast
RecastAudioManifestV1, RecastAudioLayerName, RecastAudioMix, RecastAudioMixControl, RecastAudioSectionReplacement, RecastRescoreReplacement, RecastRescoreOperation, EstimateRecastRescoreInput, RecastRescoreRequestV2, RecastRescoreQuote, RecastRescoreResponseRecast
PipelineStageName, BranchPipelineInput, BranchPipelineResult, ChatTurn, ChatStageResult, ApplyChatProposalResult파이프라인
CopilotThread, CopilotThreadWorkflow, CopilotSurface, CopilotRunMode, CopilotModelTier, CopilotMessage, CopilotMessagePart, CreateCopilotThreadInput, CopilotStreamOptions, CopilotStreamFrame 및 프레임 데이터 타입Copilot

계정과 카탈로그

내보내는 항목설명 페이지
ModelSummary, ModelMaker, ModelsListResult, ListModelsOptions, UserBalance, ModelCostsResult, FreeGrantState, WelcomeOfferState, WelcomeOfferClaimInput, WelcomeOfferClaimResult모델과 크레딧
BillingPlansResult, BillingPlan, BillingPlanPrices, BillingMoney, BillingMonthlyPrice, BillingYearlyPrice, BillingPriceCredits, BillingTopUp, BillingSubscriptionResult, BillingSubscription, BillingSurface, BillingAccountSummary, BillingUsageCategory모델과 크레딧
PickerCatalog, PickerCatalogSummary, PickerOption, PickerDimension, PickerCatalogSection, GetPickerCatalogOptions피커, 프리셋, 프롬프트
CatalogsListResponse, ProjectedCatalog, ProjectedCatalogOption, ProjectedCatalogDimension, ProjectedCatalogSection피커, 프리셋, 프롬프트
NodePreset, NodePresetGroup, FactoryPresetsResult, FactoryPresetEntry, CreateNodePresetInput, UpdateNodePresetInput, ImportNodePresetInput, ReorderNodePresetsInput피커, 프리셋, 프롬프트
ColorPalette, PalettePage, ListPalettesParams, CreatePaletteInput, UpdatePaletteInput, Moodboard, MoodboardPage, ListMoodboardsParams, CreateMoodboardInput, UpdateMoodboardInput, DirectionFields피커, 프리셋, 프롬프트
AnalyzeInput, AnalyzeResult, GenerateInput, EnhanceInput, PromptResult, WizardQuestion, WizardOption, WizardSelection, RecommendedModel, WizardNodeContext피커, 프리셋, 프롬프트
OrganizationView, OrganizationSummary, OrgMemberView, OrgKind, OrgRole, OrgStatus, OrgSettings, OrgAuditEntry, OrgPage, OrgErrorCode, MemberStatus, CreateOrgInput, InviteInput, ListInvitationsOptions조직과 워크스페이스
InvitationView, InvitationDelivery, InvitationPreview, InvitationState, JoinCodeView조직과 워크스페이스
WorkspaceView, WorkspaceSummary, WorkspaceMemberView, WorkspaceRole, WorkspaceSettings, CreateWorkspaceInput조직과 워크스페이스
UsageQuery, UsageGroupBy, UsageReport, UsageReportRow, UsageReportTotals, UsageVarianceRow, UsageLogEntry조직과 워크스페이스
DeveloperApp, DeveloperAppScope, DeveloperAppStatus, DeveloperAppKind, CreateDeveloperAppInput, UpdateDeveloperAppInput, CreateDeveloperAppResult, RotateSecretResultOAuth와 개발자 앱
ExchangeCodeInput, AccessTokenResponse, OAuthAppInfoOAuth와 개발자 앱

헬퍼 함수와 상수

이것들은 타입이 아니라 값이므로 type 없이 가져오세요.

내보내는 항목설명
nodeStateMayCarryOutput(status), OUTPUT_BEARING_NODE_STATUSES노드 상태가 output을 담을 수 있는지 여부입니다. 해당 상태는 completed와 failed입니다. 작업과 실행을 참고하세요.
executionOutcome(status, nodeStates), countEmptyInputSkips(nodeStates)완료된 실행이 새로운 것을 찾지 못했는지, 그리고 입력이 없어 건너뛴 노드가 몇 개인지 알려 줍니다. 작업과 실행을 참고하세요.
isStudioGenerateEstimate(result)생성 견적과 시작된 실행을 구분합니다. 스튜디오 프로덕션을 참고하세요.
unwrapEditPlanOutput(outputData)편집 계획 작업의 출력을 EDL, EDL 목록 또는 챕터로 읽습니다. 편집을 참고하세요.
verifyWebhookSignature(options)Webhook 호출의 서명을 확인하고 이벤트를 반환합니다. 작업과 실행을 참고하세요.
paletteDirectionId(id), moodboardDirectionId(id), PALETTE_DIRECTION_PREFIX, MOODBOARD_DIRECTION_PREFIX팔레트나 무드보드의 direction 값을 만듭니다. 피커, 프리셋, 프롬프트를 참고하세요.
throwFromResponse(status, body)API 응답에 맞는 오류 클래스를 발생시킵니다. 오류를 참고하세요.
PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY앞뒤 텍스트의 노드 데이터 키입니다.
WORKSPACE_HEADER워크스페이스 헤더의 이름인 X-Nodaro-Workspace입니다.
USAGE_GROUP_BYS사용량 보고서가 받는 그룹화 방식입니다.
LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, SURROUND_DIRECTIONS허용되는 장소 변형 유형, 컬렉션, 서라운드 방향입니다.
OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, OBJECT_ASPECT_OPTIONS, OBJECT_ASPECT_DEFAULTS허용되는 오브젝트 변형 유형, 컬렉션, 화면 비율입니다.
CREATURE_ASSET_TYPES, CREATURE_ATTACH_COLUMNS, CREATURE_ASPECT_OPTIONS, CREATURE_ASPECT_DEFAULTS크리처에 대한 같은 목록입니다.
CHARACTER_STYLES, CHARACTER_ASPECT_OPTIONS, CHARACTER_ASPECT_DEFAULTS캐릭터 스타일과 화면 비율입니다.
SCENE3D_DELIVERY_ASSET_USAGE허용되는 전달 파일 종류와 용도의 쌍입니다.

WorkflowsResource나 NodesResource 같은 모든 리소스 클래스도 고급 타입 지정을 위해 내보냅니다. 이 클래스가 필요한 경우는 드뭅니다. createClient가 모든 리소스를 만들어 주기 때문입니다.

자주 묻는 질문

Nodaro SDK에서 타입을 가져오려면 어떻게 하나요?

타입 이름과 함께 import type을 사용하세요. 예를 들어 import type { Workflow, Job } from @nodaro/sdk처럼 씁니다. 메서드가 쓰는 타입 중 일부는 내보내지 않습니다. 그런 타입은 @nodaro/shared에서 가져오거나 메서드에서 도출하세요.

어떤 필드는 snake_case이고 어떤 필드는 camelCase인 이유는 무엇인가요?

타입은 API의 전송 형식을 따릅니다. Job은 API가 그렇게 보내기 때문에 output_data, created_at 같은 snake_case를 씁니다. Workflow와 WorkflowExecution은 camelCase를 씁니다.

@nodaro/shared도 필요한가요?

보통은 필요 없습니다. SDK는 조직 타입과 편집 타입처럼 메서드가 쓰는 공유 타입 대부분을 다시 내보냅니다. 3D 검토 헬퍼와 toConnectedReference 같은 일부 헬퍼, PipelineInput과 CommunityFullDetail 같은 일부 타입은 @nodaro/shared에서 직접 가져옵니다.

최종 업데이트

목차