開発者向けツール

あなたのエージェントをサウンドスタジオに変える

Sonilo を AI エージェントに接続すれば、ライセンス済みの音楽、効果音、動画翻訳を会話の中からそのまま生成できます。エージェントからサインインするだけで、作成が必要な API キーはありません。

あなたのターミナルをサウンドスタジオに変える

Sonilo API のすべての機能を CLI で使えます。スクリプト化、パイプ処理、CI ジョブや Dockerfile への組み込みも自由自在。npm または PyPI からインストールできます。

エージェントにサウンドデザインを教える

話しかけるだけで自動的に起動する、11 のオープンソーススキル。スコアリング、SFX、動画翻訳、ダッキングをカバーします。エージェントがスキルを選び、スキルが API を動かします。

1

Claude のコネクタ設定を開く

Claude と Claude Code のどちらでも使えます。下のリンクからコネクタ設定へ直接移動できます。

2

カスタムコネクタを追加する

名前を Sonilo にして、下の URL を貼り付けます。保存してください。

3

接続してサインインする

接続し、Sonilo アカウントでサインインして、エージェントに動画への作曲を頼みましょう。フロー全体を通して API キーは一切登場しません。

1

CLI をインストール

npm でも PyPI でもコマンド 1 つ。サブコマンドも出力も同じです。

2

サインイン

OAuth はブラウザで完了します。資格情報はお使いのマシンに保存され、以降はすべてのコマンドが自動で読み取ります。貼り付けもローテーションも不要です。

3

生成する

各エンドポイントはサブコマンドです。非同期ジョブは自動でポーリングされ、あとはファイルを受け取るだけです。

1

インストールする

1つのコマンドで 11 のスキルすべてを対応アシスタントに追加できます。必要なものだけを選ぶこともできます。

2

Sonilo に接続

スキルは指示書で、実際に動かすツールを提供するのは MCP サーバーです。サーバーを登録してから一度サインインすれば、その資格情報は CLI にも効きます。MCP ホストがない場合は、CLI を入れてサインインするだけで、スキルが自動的に CLI へ切り替わります。

3

チャットで頼む

スキルを追加したエージェント(Claude Code と Codex)をサインインした状態で開き、ターミナルではなくそのチャットに入力します。スキルは普通の言葉で自動的に起動するので、ツール名もパラメータも要らず、欲しい結果を説明するだけです。

text-to-musicvideo-to-musictext-to-sfxvideo-to-sfxvideo-to-soundaudio-duckingauto-dubbingtask-recoveryaccountaudio-playbacksetup-api-key

CLI 1つで、Sonilo のすべてのエンドポイントに対応

API 全体を1つのコマンドに。npm と PyPI から入手でき、環境変数1つで動き、JSON で応答します。任意のターミナル、CI ジョブ、Dockerfile に組み込んで、レンダリング済みフォルダをバッチでスコアリングしたり、生成をビルドに組み込んだり、リリースを10言語に翻訳したりできます。非同期ジョブは自動でポーリングされ、あとはファイルを受け取るだけです。

16 個のコマンド9 個の生成エンドポイント2 個のパッケージ--json すべてのコマンドで
シェルで実行してください。どのターミナル、CIジョブ、Dockerfile でも動作します。
npmNodenpm install -g sonilo-cli
PyPIPythonpip install sonilo-cli
npxインストール不要npx sonilo-cli account

sonilo login で一度サインインしてください。資格情報は MCP サーバーと共有されるため、ここでのサインインが両方をカバーします。CI では代わりに SONILO_API_KEY を設定してください。 ドキュメントを開く →

実行sonilo video-to-music --video clip.mp4
m4a · 30 sec

実際の出力。Sonilo CLI が生成しました。

普通の言葉で頼む、またはコマンドを実行する

12個の機能と3個のアカウントツール。それぞれエージェントにとっては1回の MCP ツール呼び出し、シェルでは1つのコマンド、スキルをインストールしていればただの一文で済みます。

musicvideo_to_music

「このクリップに、カット編集に合わせた音楽をつけて」

musictext_to_music

「雨音の下に温かみのあるローファイピアノを30秒作って」

musicvideo_to_video_music

「このクリップにサウンドトラックを追加して、映像を返して」

sound effectsvideo_to_sfx

「このクリップで起きていることに合わせて効果音を追加して」

sound effectstext_to_sfx

「コンクリートの上で割れるガラス瓶の音が欲しい」

sound effectsvideo_to_video_sfx

「このクリップに効果音をミックスして、映像を返して」

soundvideo_to_sound

「このクリップに音楽と効果音をバランスよくミックスして」

soundvideo_to_video_sound

「このクリップに完成サウンドトラックをつけて、映像にミックスして返して」

audioaudio_ducking

「このナレーションの下で音楽をダッキングして」

speechdubbing

「この動画を日本語とスペイン語に翻訳して、音楽のベッドは残して」

speechproofread

「このクリップを文字起こしして、編集できる日本語とスペイン語の字幕をちょうだい」

videoanalyze_video

「生成する前に、このクリップを見て音楽と効果音のプランを立てて」

get_generation_task

非同期ジョブをポーリング

get_usage

利用額とクォータ

get_account_services

あなたのキーでできること

連鎖する機能

1つのリクエストが複数のツールを通じて処理されることがあります。頼んだ内容に応じてエージェントが連鎖を選び、CLI からは同じ手順を順番に実行します。

カットを作曲し、セリフをはっきり保つ

「このカットに音楽をつけて、セリフを音楽より前面に保って」

cut.mp4video_to_musicaudio_duckingscored.m4a

スポットを複数言語で展開する

「サウンドトラックを追加して、それから日本語版とスペイン語版をください」

spot.mp4video_to_video_musicdubbingspot-ja.mp4 · spot-es.mp4

レンダリング済みフォルダのサウンドデザイン

「./renders 内のすべてのクリップにフォーリーを追加して」

renders/*.mp4video_to_sfx×12renders/*.m4a

よくある質問

ターミナルから生成を始めましょう