REST API
すべてのエンドポイントで Authorization: Bearer <キー> が必要です。 機械可読な仕様は /openapi.json、 サイト全体の概要は /llms.txt にあります。
有効期限が切れたとき
期限切れのキーで接続すると、401 と次の形式で返ります。 エージェントがそのまま利用者に案内できるよう、理由と次の行動を含めています。
{
"error": {
"code": "api_key_expired",
"message": "この API キーは 2026/10/24 に有効期限が切れました。…",
"renewUrl": "https://xaimp3.com/developers",
"action": "reissue_api_key"
}
}期限まで 14 日を切ると /api/v1/me に warning が付きます。 定期的に叩いておけば、切れる前に気づけます。
楽曲を探す
curl "https://xaimp3.com/api/v1/tracks?scene=opening&duration=30&duckFriendly=true&limit=5" \ -H "Authorization: Bearer aimp3_live_..."
絞り込みに使えるもの: scene / mood / onomatopoeia /duration / bpmMin / bpmMax / duckFriendly /q（自由入力）/ limit / offset
自然文で探す
curl -X POST "https://xaimp3.com/api/v1/search" \
-H "Authorization: Bearer aimp3_live_..." \
-H "Content-Type: application/json" \
-d '{"query":"落ち着いたウェビナー待機画面用、ナレーションの下に敷ける","limit":5}'1曲の詳細と、似た曲
curl "https://xaimp3.com/api/v1/tracks/aimp3_0001" \ -H "Authorization: Bearer aimp3_live_..."
ダウンロード
curl "https://xaimp3.com/api/v1/tracks/aimp3_0001/download?variant=30s" \ -H "Authorization: Bearer aimp3_live_..."
variant は full / 60s / 30s /15s / loop / preview。 応答に含まれる url から実ファイルを取得します。
ライセンス証明書の発行
curl -X POST "https://xaimp3.com/api/v1/license" \
-H "Authorization: Bearer aimp3_live_..." \
-H "Content-Type: application/json" \
-d '{"trackId":"aimp3_0001","holder":"株式会社◯◯","usedIn":"採用説明会動画"}'発行された URL は誰でも開けます。クライアントや広告審査に 「このURLを見てください」と渡せる形の証明書です。
利用状況
curl "https://xaimp3.com/api/v1/me" -H "Authorization: Bearer aimp3_live_..."
MCP サーバー
Claude Code / Claude Desktop などの MCP 対応クライアントから、 「この動画に合う 30 秒の BGM を探して落として」と言うだけで完結します。
{
"mcpServers": {
"aimp3": {
"command": "npx",
"args": ["-y", "aimp3-mcp"],
"env": {
"AIMP3_API_KEY": "aimp3_live_...",
"AIMP3_BASE_URL": "https://xaimp3.com"
}
}
}
}提供しているツール: search_bgm（自然文で検索）/list_bgm（条件で絞り込み）/ get_bgm（詳細と似た曲）/download_bgm（ファイルを保存）/ issue_license（証明書の発行）
ライセンス
API 経由で取得した楽曲も、サイトからダウンロードした場合と同じライセンスです。 商用利用可・クレジット表記不要。詳細はライセンスをご覧ください。