개발자

Nodaro는 REST 우선으로 만들어졌습니다. Nodaro 편집기, TypeScript SDK, CLI는 모두 같은 HTTP API와 통신하므로, Nodaro에서 하는 모든 일은 Bearer 토큰과 JSON 요청으로 자동화할 수 있습니다. 이 섹션은 그 API와 클라이언트, 인증 방법, 그리고 Nodaro를 내 제품 안에 넣는 방법을 설명합니다. AI 어시스턴트는 MCP 서버를 통해 같은 워크플로와 모델에 접근합니다.

세 가지 사용 방법

SDK는 fetch와 URL을 사용하므로 Node.js 20 이상, 브라우저, React Native, 그리고 Cloudflare Workers, Deno, Bun에서 작동합니다. CLI는 SDK를 감싼 얇은 래퍼입니다. CLI가 하는 일은 SDK도 모두 할 수 있습니다.

저장된 워크플로를 실행하는 같은 호출을 세 가지 방법으로 보여 줍니다.

curl -s -X POST https://app.nodaro.ai/v1/workflows/8c2d7f1e-3a4b-4c5d-9e6f-7a8b9c0d1e2f/run \
  -H "Authorization: Bearer $NODARO_API_KEY"
# {"executionId":"3f9e2b1a-…","status":"pending"}

import { createClient, StaticTokenAuth } from '@nodaro/sdk'

const client = createClient({
  baseUrl: 'https://app.nodaro.ai',
  auth: new StaticTokenAuth(process.env.NODARO_API_KEY!),
})

const { executionId } = await client.workflows.run('8c2d7f1e-3a4b-4c5d-9e6f-7a8b9c0d1e2f')

nodaro auth login --token "$NODARO_API_KEY"
nodaro workflows run 8c2d7f1e-3a4b-4c5d-9e6f-7a8b9c0d1e2f --watch

세 가지는 어디서나 같은 방식으로 작동합니다.

• 무엇이든 실행합니다. 저장된 워크플로, 게시된 앱, 또는 단일 노드를 POST /v1/<node-type>으로 실행할 수 있으며, 워크플로를 만들 필요가 없습니다.
• 결과를 폴링합니다. 생성에는 몇 초에서 몇 분이 걸리므로, 실행은 즉시 ID를 반환하고, 그 작업이나 실행을 폴링합니다. SDK와 CLI는 대신 기다려 줄 수 있습니다.
• 토큰 없이 살펴봅니다. GET /v1/nodes와 GET /v1/models는 모든 노드와 모델을 설정, 크레딧 가격과 함께 나열합니다.

인증

API 토큰은 Nodaro Cloud와 Business 에디션에서 사용할 수 있습니다. 셀프 호스팅 설치도 OAuth 없이 개인 API 토큰으로 생성을 Nodaro Cloud에서 실행할 수 있습니다. 인증과 OAuth 앱을 읽어 보세요.

OpenAPI 사양

서버는 API 핵심 부분의 OpenAPI 3.1 사양을 https://app.nodaro.ai/v1/openapi.json에 게시합니다. 이 사양으로 Go, Rust, Python 또는 다른 언어의 타입이 지정된 클라이언트를 생성하세요. OpenAPI 사양을 참조하세요.

AI 에이전트용

• MCP. Claude, ChatGPT, Cursor 및 다른 MCP 클라이언트에 https://mcp.nodaro.ai/mcp를 사용자 지정 커넥터로 추가하세요. 어시스턴트는 내 Nodaro 계정으로 로그인하고, 미디어를 생성하고, 워크플로를 만들고 실행하고, 캐릭터와 다른 에셋을 관리하는 도구를 얻습니다. MCP를 참조하세요.
• 에이전트 스킬. 스킬 파일은 Claude Code, Cursor 같은 코딩 어시스턴트에게 SDK 사용법과 OAuth 앱을 만드는 방법을 가르칩니다. 에이전트 스킬을 참조하세요.

내 제품에 Nodaro 넣기

• 앱을 임베드합니다. 게시된 Nodaro 앱을 내 웹 인터페이스나 모바일 인터페이스에서 실행하세요. 임베드를 참조하세요.
• 피커를 직접 만듭니다. 크리에이티브 컨트롤 카탈로그는 @nodaro/prompts에 데이터로 들어 있으므로, 내 앱에서도 같은 선택지를 제공하고 같은 프롬프트를 작성할 수 있습니다. 피커 카탈로그를 참조하세요.
• 내 ID 공급자로 사용자를 로그인시킵니다. SSO를 참조하세요.
• 자체 지갑으로 청구합니다. 배포 환경은 각 고객의 지출을 자체 지갑으로 승인할 수 있습니다. 외부 지갑을 참조하세요.

개발자 문서 살펴보기