FFHubとは？

FFHubはクラウドベースのFFmpeg APIサービスで、シンプルなREST API呼び出しでFFmpegコマンドを実行できます。サーバー構築不要、依存関係なし。コマンドを送信するだけで結果を取得できます。

クイックスタート

1. APIキーの取得

ffhub.ioでサインアップし、ダッシュボードでAPIキーを作成してください。

2. タスクの作成

curl -X POST https://api.ffhub.io/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "command": "ffmpeg -i https://example.com/input.mp4 -c:v libx264 -preset fast output.mp4"
  }'

レスポンス：

{
  "task_id": "task_abc123",
  "status": "pending",
  "created_at": "2024-01-01T00:00:00Z"
}

3. タスクステータスの確認

curl https://api.ffhub.io/v1/tasks/task_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス：

{
  "task_id": "task_abc123",
  "status": "completed",
  "created_at": "2024-01-01T00:00:00Z",
  "finished_at": "2024-01-01T00:03:35Z",
  "elapsed": "215.30",
  "total_elapsed": "220.50",
  "progress": 100,
  "outputs": [
    {
      "filename": "output.mp4",
      "url": "https://storage.ffhub.io/outputs/task_abc123/output.mp4",
      "size": 10485760
    }
  ]
}

APIリファレンス

ベースURL

https://api.ffhub.io/v1

認証

すべてのAPIリクエストにはAuthorizationヘッダーにBearerトークンが必要です：

Authorization: Bearer YOUR_API_KEY

エンドポイント

メソッド	エンドポイント	説明
POST	/tasks	新しいFFmpegタスクを作成
GET	/tasks/:id	タスクのステータスと結果を取得

タスクステータス

ステータス	説明
pending	タスクは処理待ちのキューに入っています
running	タスクは現在処理中です
completed	タスクが正常に完了しました
failed	タスクがエラーで失敗しました

料金

1クレジット = 5秒の処理時間
$1 = 1,000クレジット

実際の処理時間に対してのみ、秒単位で課金されます。

サポート

GitHub: ffhub-io/ffmpeg-cookbook（Issues & Discussions）
メール: [email protected]
Twitter: @ffhub_io

その他のリソース

詳しいAPIドキュメントはAPIリファレンスをご覧ください。

はじめに