開発者向け

Nodaro は REST ファーストで作られています。Nodaro エディター、TypeScript SDK、CLI はすべて同じ HTTP API と通信するため、Nodaro でできることは何でも、ベアラートークンと JSON リクエストで自動化できます。このセクションでは、その API とそのクライアント、認証の方法、Nodaro を自分のプロダクトに組み込む方法を説明します。AI アシスタントも、MCP サーバーを通じて同じワークフローとモデルにアクセスします。

3 つの入り口

SDK は fetch と URL を使うので、Node.js 20 以降、ブラウザー、React Native、Cloudflare Workers、Deno、Bun で動作します。CLI は SDK の薄いラッパーです。CLI でできることは、SDK でもすべてできます。

保存したワークフローを実行する、同じ呼び出しを 3 通りで示します。

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

3 つのことは、どこでも同じように動作します。

• 何でも実行できます。保存したワークフロー、公開されたアプリ、または POST /v1/<node-type> で単一のノードを、ワークフローを組まずに実行できます。
• 結果はポーリングします。生成には数秒から数分かかるため、実行を開始するとすぐに ID が返り、そのジョブまたは実行をポーリングします。SDK と CLI は、代わりに待つこともできます。
• トークンなしで調べられます。GET /v1/nodes と GET /v1/models は、すべてのノードとモデルを、その設定とクレジット料金とともに一覧表示します。

認証する

API トークンは、Nodaro Cloud と Business エディションで利用できます。セルフホスティング環境でも、個人用 API トークンを使えば、OAuth なしで生成を 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 のアプリを、自分の Web インターフェースやモバイルインターフェースから実行します。埋め込みを参照してください。
• ピッカーを自分で作ります。クリエイティブコントロールのカタログは @nodaro/shared の中にデータとして同梱されているので、自分のアプリでも同じ選択肢を提示し、同じプロンプトを書けます。ピッカーカタログを参照してください。
• 自分の ID プロバイダーでユーザーをログインさせます。SSO を参照してください。
• 自分のウォレットで課金します。デプロイメントは、各顧客の支出を自分のウォレットで承認できます。外部ウォレットを参照してください。

開発者向けドキュメントを見る