AgentBodyAgentBody
ログイン

TikTok MP4変換API

1回のPOSTでTikTok動画をMP4に変換——保存期間つきストレージURL、直接再生URL、ファイル情報を返します。

  • 1回のPOSTで1つのMP4
  • 保存期間つきストレージURL
  • 直接再生URLも同梱
  • TTL制御
  • 冪等キー対応
  • サーバーサイドでキー保持
ツールAPIAgent

リクエスト例

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

レスポンス例

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

Downloaded TikTok media links with persistent storage.

{
  "expires_at": "2026-01-08T00:00:00Z",
  "file_size_mb": 15.2,
  "play_url": "https://example.com/play.mp4",
  "storage_url": "https://example.com/storage/video.mp4",
  "ttl": "1w",
  "video_id": "7050551461734042926"
}

機能特徴

tiktok.video_downloadオペレーションは公開TikTok動画のメディアファイルをダウンロードします。APIキーはサーバー側で保持。エンドポイントは1回の呼び出しで保存期間つきストレージURLと直接再生URLを返します。

1回のPOSTで1つのMP4

/v1/tiktok/video/download にTikTok動画URLをPOST。成功時の200は video_id・play_url・storage_url・file_size_mb・ttl・expires_at を返します。メディアパイプラインに必要な情報が1レスポンスに揃います。

保存期間つきストレージURL

storage_urlは完全に保存されたMP4ファイルを指し、選択したTTL保存期間内有効です。期限切れになるCDNリダイレクトではありません。キューワーカーに渡して数時間後に取得しても再変換不要です。

直接再生URLも同梱

保存ファイルに加え、即時再生・ストリーミング用のplay_urlも返ります。プレビューにはplay_url、ダウンロードにはstorage_url——同じ呼び出しで両方得られます。

TTL制御

オプションのttlパラメータでストレージファイルの保存期間を選択。レスポンスはTTLと正確なexpires_atタイムスタンプをエコーするため、パイプラインは常にダウンロード期限を把握できます。

冪等キー対応

Idempotency-Keyヘッダーを付ければ、失敗したリクエストを二重課金なしで安全にリトライできます。ゲートウェイがキーで重複排除するため、ネットワークリトライが同じ動画の二度目のダウンロードを起こしません。

サーバーサイドでキー保持

エンドポイントにはサーバー側で保持するAgentBody APIキーが必要です。クライアント側コードにキーを含めないでください。すべての呼び出しはバックエンド経由で、キーの安全と利用量の追跡を確保します。

使い方

3ステップでTikTok MP4変換をシステムに組み込めます。

01

APIキーを取得

無料のAgentBodyアカウントを作成し、ダッシュボードでAPIキーを生成。キーは全リクエストの認証と残高への利用量計上に使われます。

02

動画URLをPOST

/v1/tiktok/video/download にTikTok動画URLをリクエストボディに入れてPOST。オプションでttlにストレージ保存期間を指定し、安全なリトライのためIdempotency-Keyヘッダーを付けます。

03

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

成功時の200はstorage_urlとplay_urlに加え、動画ID・ファイルサイズ・有効期限タイムスタンプを返します。storage_urlからMP4をダウンロード、またはplay_urlで直接再生。

よくある質問

TikTok MP4変換APIの仕組みは？

/v1/tiktok/video/download にTikTok動画URLをPOSTします。APIが動画のメディアファイルをダウンロードして保存ストレージに格納し、ストレージURL・直接再生URL・動画ID・ファイルサイズ・有効期限タイムスタンプを返します。

urlパラメータはどの形式に対応？

urlはTikTok動画リンク——完全なtiktok.com動画URLまたは共有短縮リンクを受け付けます。APIはリンクを基になる公開動画に解決します。非公開・削除済み動画は400または502を返します。

ストレージURLの有効期限は？

storage_urlはttlパラメータで選んだ保存期間中有効です。レスポンスはttlと正確なexpires_atタイムスタンプをエコーします。期限前にダウンロードするか、新しい冪等キーで再変換してください。

どんなエラーコードが返りますか？

400は不正・非対応のURL、401はAPIキー欠落・無効、409は冪等性の競合、502/503/504は上流障害です。失敗は課金されません。上流エラーは同じ冪等キーでリトライしてください。

APIは透かし除去や再エンコードをしますか？

しません。APIはプラットフォームが提供するメディアファイルをそのまま保存し、再エンコードや透かし除去の保証はありません。受け取るMP4はソースストリームと同じです。TikTokの規約とクリエイターの権利の範囲内でご利用ください。

一括変換はできますか？

1回の呼び出しで変換できるのは1本の動画のみです。一括処理はURLリストをループし、動画ごとに1回のPOSTと固有の冪等キーを使ってください。1回あたりの価格は固定で料金ページに記載されています。