NodaroAccount
Nodaro ドキュメント
ドキュメントノードリファレンスモデルテンプレートAI エージェント(MCP)開発者向けセルフホスティングリサーチ比較

開発者向け

REST API、TypeScript SDK、CLI を使って Nodaro の上にプロダクトを構築します。API トークンや OAuth で認証し、OpenAPI からクライアントを生成し、MCP で AI エージェントを接続します。

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

3 つの入り口

入り口インストール用途
REST API不要:https://app.nodaro.ai/v1/ に HTTPS リクエストを送るだけどんな言語、どんなプラットフォームでも
TypeScript SDKnpm install @nodaro/sdkNode、ブラウザー、React Native、エッジランタイムでの型付きコード
CLInpm install -g @nodaro/cli、またはスタンドアロンのバイナリターミナル、cron ジョブ、CI パイプライン

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 トークンndr_…自分のサーバー、スクリプト、CI ジョブが、自分のアカウントで Nodaro を呼び出す場合です。設定 › APIトークンで作成します。
OAuth アクセストークンndr_app_…プロダクトが、ユーザー自身の Nodaro アカウントで、その同意のもとにワークフローを実行する場合です。
セッションの JWTJWTセルフホスティングの Community エディションを自分用に運用する場合です。

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/prompts の中にデータとして同梱されているので、自分のアプリでも同じ選択肢を提示し、同じプロンプトを書けます。ピッカーカタログを参照してください。
  • 自分の ID プロバイダーでユーザーをログインさせます。SSO を参照してください。
  • 自分のウォレットで課金します。デプロイメントは、各顧客の支出を自分のウォレットで承認できます。外部ウォレットを参照してください。

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

よくある質問

Nodaro に API はありますか?

はい。https://app.nodaro.ai/v1/ にある Nodaro の REST API は、ワークフローと単一のノードを実行し、ジョブのステータスを報告し、メディアを保存し、キャラクターなどのアセットを管理します。JSON とベアラートークンを使い、同じ API がセルフホスティング環境でも動作します。

Nodaro API の公式 SDK はありますか?

はい、TypeScript と JavaScript 向けの @nodaro/sdk です。Node.js 20 以降のほか、ブラウザー、React Native、Cloudflare Workers、Deno、Bun など、グローバルな fetch と URL を持つあらゆるランタイムで動作します。

AI エージェントは、どうやって Nodaro を使いますか?

https://mcp.nodaro.ai/mcp にある Nodaro MCP サーバーを通じてです。Claude、ChatGPT、Cursor などのアシスタントが、あなたの Nodaro アカウントでログインすると、メディアの生成、ワークフローの作成と実行ができるようになります。

セルフホスティングの Community エディションでも API を使えますか?

はい。Community エディションのインストール環境は同じエンドポイントを提供し、認証にはログイン中のセッションの JWT を使います。API トークンには Business エディションか Nodaro Cloud が必要で、クレジットは Nodaro Cloud にしかありません。

API トークンと OAuth のどちらを使うべきですか?

自分のサーバーが自分のアカウントで Nodaro を呼び出す場合は、個人用 API トークンを使います。プロダクトを構築し、そのユーザーがそれぞれ自分の Nodaro アカウントをプロダクトに接続する場合は、OAuth を使います。

最終更新

目次