新規ユーザーは無料クレジットを獲得、クレジットカード不要 はじめる
APIAny logoAPIAny

動画サムネイルを抽出

指定時刻の JPEG または WebP サムネイルを取得。

POST /api/free/video-thumbnail

動画サムネイルを抽出をオンラインで使用

API キーなしでアップロード、設定、プレビュー、ダウンロードできます。

ログイン・API キー不要

1. アップロードと設定

API キーなしで利用できます。ファイルは実行時にのみ送信されます。

動画ファイル *
時刻（秒）
サムネイル幅
出力形式
必須項目を入力すると実行できます。POST /api/free-online/video-thumbnail

2. プレビューとダウンロード

結果はここに表示されます

プレビュー、サイズ変化、ダウンロード操作を表示します

API で連携

API キーが必要なのはプログラムからの呼び出しだけです。パラメータ、レスポンス、エラーを以下にまとめています。

API エンドポイント
POST /api/free/video-thumbnail

オンライン利用はキー不要です。プログラムからの呼び出しには APIAny キーが必要です。

仕組み
  • 時刻は動画の再生時間内に指定します。
  • 幅は最大 1920 ピクセルです。

レスポンス

成功時は、このページに記載した Content-Type の image レスポンスを返します。

主なエラー

400
ファイルやパラメータが不足、不正、または制限外です。
401
プログラム呼び出しのキーがない、無効、または停止済みです。
429
オンラインまたは認証済みの共有上限に達しました。

パラメータと制限

パラメータ要件既定値利用可能な値
video動画ファイル必須—file
timestamp時刻（秒）任意0number
widthサムネイル幅任意1280number
format出力形式任意webpwebp, jpeg

API の例

以下はコード用の認証例です。上の Playground は API キーを要求・表示しません。

curl -X POST "https://apiany.ai/api/free/video-thumbnail" \
  -H "Authorization: Bearer $API_KEY" \
  -F "video=@input.mp4" \
  -F "timestamp=2" \
  --output thumbnail.webp

よくある質問

動画サムネイルを抽出 に API キーは必要ですか？

オンライン Playground では不要です。プログラムからは Authorization: Bearer または X-API-Key を使います。

動画サムネイルを抽出 の制限は？

オンラインは毎分 3 回、1 日 30 回です。認証済み無料アカウントは 5 RPM、有料アカウントは全無料 API 合計で 500 RPM です。

動画サムネイルを抽出 が受け付ける入力は？

パラメータ表の必須・任意項目を使用してください。未対応形式や範囲外の値は拒否されます。

動画サムネイルを抽出 は何を返しますか？

成功時は image レスポンス、失敗時は上記の HTTP ステータスを返します。

出典：APIAny 無料 API カタログと実際のルート動作。確認日：2026-07-17。