ログイン

Cloud API

一つの API で動画を理解し、
文脈を保持し、

必要な瞬間を呼び出す。

Web サービス、CLI、agent から Hosted REST 契約を利用できます。アップロード、保存、クラウド実行は常に明示されます。

POST /search200 · 82ms
{
  "request_id": "req_01k2cerul7c41ad",
  "usage": {
    "billable": true,
    "quantity": 1,
    "unit": "request"
  },
  "warnings": [],
  "data": [
    {
      "id": "ev_7c41ad",
      "video_id": "asset_2a91fc",
      "start_seconds": 768,
      "end_seconds": 794,
      "score": 0.82,
      "type": "speech",
      "text": "Scaling laws still hold if you look at loss, not benchmarks.",
      "related": [
        {
          "type": "screen_text",
          "start_seconds": 770,
          "end_seconds": 780,
          "text": "Loss vs. compute"
        }
      ],
      "context": {
        "before": [
          {
            "type": "speech",
            "start_seconds": 751.2,
            "end_seconds": 767.9,
            "text": "So what actually changed over the last year?"
          }
        ],
        "after": []
      },
      "thumbnail_url": "https://media.cerul.ai/v/asset_2a91fc/thumb.jpg?t=768&exp=1790334000&sig=3f9c",
      "playback": {
        "url": "https://media.cerul.ai/v/asset_2a91fc/web.mp4?exp=1790334000&sig=3f9c#t=768,794",
        "format": "mp4",
        "expires_at": "2026-09-25T10:00:00Z"
      },
      "console_url": "https://cerul.ai/console/videos/asset_2a91fc?t=768",
      "video": {
        "filename": "dwarkesh-dario-amodei.mp4",
        "duration_seconds": 8640,
        "summary": "A long-form interview on scaling, training data and AI safety.",
        "summary_generated": true
      }
    }
  ]
}

エンドポイント

POST
/videos

動画ファイルをアップロード

GET
/videos/{video_id}

検索可能かどうかを確認

POST
/search

意味で検索し、タイムコード付きのクリップを返す

POST
/exports

時間範囲を MP4 ファイルとして書き出す

完全な契約は OpenAPI リファレンスへ

4 ステップのフロー

アップロード、処理、クリップの検索、書き出し。各ステップの状態を追跡できます。

01

Key を作成

Console → API Keys で作成し、一度だけ表示されるシークレットを保存します。

02

アップロード先を取得

直接アップロード先を取得し、返されたヘッダーで正確なバイトを PUT します。

03

完了して待つ

アップロードを確定し、ready になるまでポーリングします。

04

検索 / 書き出し

POST /search でクリップを取得し、POST /exports で時間範囲を MP4 に書き出します。

現在の連携方法はファイルのアップロードです。URL インポートは本トライアルに含まれません。注釈には専用スコープが必要です。出力例は性能・品質の保証ではありません。

動画の中から、必要な瞬間を。