AgentBodyAgentBody
ログイン

YouTube WAV API

1回の POST で公開 YouTube 動画を WAV に変換。レスポンスは永久的な音声ダウンロード URL と標準化されたトラックメタデータを返します。

  • 1回の POST、1つの WAV ファイル
  • 永久的なダウンロード URL
  • PCM デコード、2回目の非可逆パスなし
  • 1つのエンドポイントで8つのフォーマット
  • 冪等キーサポート
  • サーバーサイドキー必須
ツールAPIAgent

リクエスト例

API ドキュメントを見る 完全な API リファレンス 
curl -X POST "https://api.agentbody.io/v1/youtube/audio/download" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"bitrate":"source","format":"mp3","url":"YOUR_URL"}'

レスポンス例

OpenAPI 仕様に記載されたレスポンス。

Retained audio file URL and normalized public track metadata.

{
  "audio_url": "https://example.com/audio-dQw4w9WgXcQ.mp3",
  "bitrate": "192k",
  "channel": "Example Channel",
  "duration_seconds": 212,
  "file_size_bytes": 3407872,
  "format": "mp3",
  "thumbnail_url": "https://example.com/thumbnail-dQw4w9WgXcQ",
  "title": "Example Track",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "video_id": "dQw4w9WgXcQ"
}

機能特徴

youtube.audio_download 操作に format=wav を指定すると、1つの公開動画が保存された WAV ファイルに変換されます。サーバーが API キーを保持；エンドポイントは1回の呼び出しで永久的なダウンロード URL を返します。

1回の POST、1つの WAV ファイル

POST /v1/youtube/audio/download に動画 URL と format: "wav" を送信します。成功した 200 は video_id、title、channel、duration、audio_url、format、file_size_bytes を返します。

永久的なダウンロード URL

audio_url は期限切れの CDN リダイレクトではなく、完全に保存されたファイルを指しています。どのサーバー、どの IP、いつでもダウンロード可能です。

PCM デコード、2回目の非可逆パスなし

WAV 出力は非圧縮 PCM に一度デコードされ、再圧縮されることはありません。ソースストリームが品質の上限を決めますが、出口で失われるものはありません。

1つのエンドポイントで8つのフォーマット

format パラメータは wav、mp3、m4a、aac、flac、opus、vorbis、alac を受け入れます。1つの統合で製品に必要なすべての音声出力をカバーします。

冪等キーサポート

Idempotency-Key ヘッダーを渡すと、再試行が2回目の変換や課金をトリガーしません。ゲートウェイはキーで重複を排除します。

サーバーサイドキー必須

エンドポイントはサーバーが保持する AgentBody API キーが必要です。バックエンド経由で呼び出しをルーティングし、キーをクライアントバンドルに出荷しないでください。

使い方

3ステップで API に YouTube WAV 変換を統合。

01

API キーを取得

無料 AgentBody アカウントを作成し、ダッシュボードから API キーを生成します。

02

format=wav で POST

/v1/youtube/audio/download に POST リクエストと公開動画 URL、"format": "wav" を送信します。安全な再試行のために Idempotency-Key ヘッダーを含めます。

03

ダウンロードリンクを受信

200 は永久的な WAV URL とタイトル、チャンネル、再生時間、ファイルサイズを返します。直接ダウンロードするか、ストレージパイプラインに渡します。

よくある質問

YouTube WAV API はどのように動作しますか？

/v1/youtube/audio/download に POST リクエストと公開動画 URL、"format": "wav" を送信します。API は音声を変換し、WAV ファイルを保存し、標準化されたメタデータ付きの永久的なダウンロード URL を返します。

レスポンスには何が含まれますか？

video_id、url、title、channel、duration_seconds、audio_url（永久的な WAV ダウンロードリンク）、thumbnail_url、format（"wav"）、bitrate、file_size_bytes です。

WAV 出力はロスレスですか？

WAV 出力は2回目の非可逆パスなしの非圧縮 PCM です。品質の上限は YouTube が提供するソースストリームです——API は存在しなかったディテールを復元すると主張しません。

エンドポイントは他にどのフォーマットをサポートしていますか？

mp3、m4a、wav、aac、flac、opus、vorbis、alac——すべて同じエンドポイントの format パラメータ経由。1つの統合ですべての出力をカバーします。

課金はどのように行われますか？

各成功した変換は、ゲートウェイ管理価格で AgentBody 残高から固定金額を消費します。失敗は課金されません；Idempotency-Key ヘッダーが再試行時の重複課金を防ぎます。

長さの制限はありますか？

約25分を超える動画は、毎回の変換を予測可能な固定価格に保つ上流のコストガードによって拒否されます。長いコンテンツは分割するか、セグメントごとに API を個別に呼び出してください。