ƒƒffhub.io

FFHub の使い方

FFHub は FFmpeg を REST API でラップしたサービス。コマンドを送って URL を受け取るだけ。

FFHub は FFmpeg を REST API として提供します。普通の ffmpeg コマンドを送信すると、クラウドワーカーで実行し、出力ファイルの URL を返します。サーバ構築もコーデック導入も運用も不要です。

目的に合う入口から始める

  • 今すぐ API を試す: Playground で実際のリクエストを送信し、レスポンスを確認。
  • バックエンドへ組み込む: Quickstart でタスク作成とポーリングの流れを実行。
  • ターミナルから使う: CLI をインストール。ローカルファイルは自動アップロード。
  • Agent に Cloud FFmpeg を追加: FFmpeg Agent Skill をインストール。

AI でクライアントコードを生成

API コンテキストを LLM に渡して、クライアントコードの下書きを生成することもできます。下のプロンプトを ChatGPT、Claude.ai、Gemini、または IDE の AI アシスタント（Cursor / Claude Code など）に貼り付けてください。私たちの llms.txt を参照しているので、モデル側に必要なコンテキストが揃います。

FFHub の動画処理 API を自分のプロジェクトに組み込みたいです。

参考コンテキスト：
- プロジェクト概要：https://ffhub.io/llms.txt
- API 仕様：https://api.ffhub.io/openapi.json

やりたいこと：<具体的なタスクを書く。例「MP4 を 192kbps の MP3 に変換」「動画の 5 秒目をサムネイル化」「動画を 10MB 以下に圧縮」>
言語 / ランタイム：<Node.js / Python / Go / Bash / ...>

そのまま実行できる完全なスクリプトを書いてください：
1. ローカルファイルがある場合：POST /v1/uploads/sign で署名付き URL を取得し、その URL に PUT でファイルを直接アップロード。PUT の Content-Type ヘッダは署名レスポンスの content_type と完全に一致させ、PUT が 2xx を返さなければエラーで中断すること（さもないと public_url は実体のないアドレスになる）。返ってきた public_url を FFmpeg の入力として使う。
2. POST /v1/tasks にリクエストし、body に `command` フィールドを入れて FFmpeg 引数と入力 URL を渡す。
3. GET /v1/tasks/{id} でタスクをポーリングし、status が succeeded または failed になるまで待ち、outputs[0].url から結果をダウンロード。
API キーは FFHUB_API_KEY 環境変数から読んでください。

Postman で試す

公開 Postman ワークスペースを使うのが一番早い動作確認方法です：

  • FFHub 公開ワークスペース — 自分の Postman に fork し、アクセストークンを差し込めば、数秒でリクエストを送信できます。

OpenAPI 仕様

完全な機械可読仕様は api.ffhub.io/openapi.json にあります — タスク管理、アカウント情報、アップロード署名エンドポイントまでカバーしています。この URL を Postman / Bruno / Insomnia に貼り付けたり、openapi-generator / openapi-typescript に渡せば、任意の言語で型付きクライアントを生成できます。

すべてのエンドポイントは Bearer アクセストークンで認証します。/dashboard/api-keys で発行してください。GET /v1/tasks/{id} は旧 ffhub-cli 互換のため現状はトークンなしでも呼べますが、将来のリリースで必須化します。

できること

  • 変換とトランスコード：任意の形式間変換、MP4 / WebM / HLS / GIF、コーデック切り替え
  • 圧縮とリサイズ：ファイル縮小、ビットレート・解像度変更
  • 編集：トリミング、結合、クロップ、回転、ウォーターマーク、字幕
  • 抽出：音声、フレーム、サムネイル、メタデータ
  • FFmpeg でできることはすべて — あなたのコマンドをそのまま実行します

料金

  • 1 クレジットで約 1 秒の課金対象処理時間
  • 登録時に無料クレジット付与、サブスク無し、クレジットの期限なし

課金対象は Worker がファイルを転送・処理する時間です。キュー待ち時間は課金されません。

ドキュメント目次

使い方に合わせて読むべきところを選んでください：

入門 — はじめての場合はこの順で。

コード例 — 動くコードをコピペしたい人向け。

  • サンプル集 — FFmpeg の典型レシピ（トランスコード、圧縮、トリミング、音声抽出、ウォーターマーク）。
  • SDK & コード例 — 同じタスクを Node.js / Python / Go で書くと。
  • 動画圧縮 — H.264 / H.265 / VP9 の比較、CRF の調整、2 パス エンコード。

統合 — HTTP コードを書きたくない場合。

  • CLI ツール — npm install -g ffhub、ターミナルからジョブを実行、ローカルファイルは自動アップロード。
  • n8n コミュニティノード — FFHub を n8n のビジュアルワークフローに組み込み。
  • FFmpeg Agent Skill — Claude Code、Codex、Cursor、OpenCode など 40 以上の対応 coding agent から FFHub を利用。

エンドポイントの詳細を見る前に高レベルな全体像を把握したい場合は FFmpeg API ガイド をご覧ください — API の目的、自分で FFmpeg を運用する場合との比較、想定ユースケースを解説しています。

サポート