imaginevid-ai-generation

ImagineVid エージェントツール AI

ImagineVid 向けのオープンソース配布パッケージです。ImagineVid は、画像、動画、音楽を生成する AI プラットフォームです。このリポジトリには、型付き REST クライアント、CLI、ローカル stdio MCP アダプターが含まれています。ホスト型 MCP サーバーは、認証、OAuth の同意、スコープ、クレジット、見積もり、冪等性、所有アセット、プロバイダーのライフサイクルに関する信頼できる情報源です。

接続方法を選択する

ホスト型 MCP

ホストがリモート MCP サーバーに対応している場合は、OAuth で保護された Streamable HTTP エンドポイントを使用してください。

{
  "mcpServers": {
    "imaginevid": {
      "url": "https://imaginevid.io/api/mcp"
    }
  }
}

ホストが OAuth と明示的な同意を処理します。このエンドポイントでは、models_list、credits_get、generation_quote、generation_create、generation_get を利用できます。製品とアカウントの利用手順については、ImagineVid のウェブサイトをご覧ください。

ローカル stdio MCP

npm パッケージのリリース後、次のようにローカルホストを設定してください。

{
  "mcpServers": {
    "imaginevid": {
      "command": "npx",
      "args": ["-y", "imaginevid-mcp"],
      "env": {
        "IMAGINEVID_API_KEY": "${IMAGINEVID_API_KEY}",
        "IMAGINEVID_BASE_URL": "https://imaginevid.io"
      }
    }
  }
}

ローカルアダプターは、スコープが限定された API キーを使用し、そのキーを出力することはありません。また、曖昧な submission_unknown の結果を再試行することもありません。受け付けるのは、製品の機能値と所有アセット ID であり、プロバイダーのパラメーター、任意のリモート URL、インラインの base64 メディアではありません。

CLI

npm パッケージのリリース後、次のように実行してください。

npm install --global imaginevid-cli
export IMAGINEVID_API_KEY="..."
imaginevid models list
imaginevid credits

CLI は assets upload、generate、generations get、generations wait にも対応しています。generate は最初に見積もりを行い、正確なクレジット数の明示的な確認と、安定した冪等性キーを必要とします。

開発

pnpm install
pnpm test
pnpm build

公開パッケージのメタデータとリリースファイルは、次の場所にあります。

• imaginevid-client：型付き Agent REST v1 クライアントです。
• imaginevid-cli：コマンドラインアダプターです。
• imaginevid-mcp：ローカル stdio MCP アダプターです。
• server.json：ホスト型 MCP Registry のメタデータです。

製品ドキュメント、生成ツール、アカウントアクセスについては、ImagineVid のウェブサイトをご覧ください。ソースコードに関する問題は、このGitHub リポジトリにお寄せください。

セキュリティとライセンス

API キーやアカウント設定をコミットしないでください。ホスト型エンドポイントは OAuth を使用します。ローカルアダプターは、環境変数または所有者のみがアクセスできるローカル設定ファイルから認証情報を読み込みます。パッケージやセキュリティに関する問題は、ImagineVid のサポートページから報告してください。

公開されている配布コードは、MIT-0 ライセンスの下で利用できます。