Key を作成
Console → API Keys で作成し、一度だけ表示されるシークレットを保存します。
Web サービス、CLI、agent から Hosted REST 契約を利用できます。アップロード、保存、クラウド実行は常に明示されます。
POST /search200 · 82ms
{
"request_id": "req_01k2cerul7c41ad",
"execution": {
"location": "cloud",
"capability_id": "search",
"capability_version": "1"
},
"usage": {
"billable": true,
"quantity": 1,
"unit": "request"
},
"warnings": [],
"data": [
{
"score": 0.93,
"evidence": {
"id": "ev_7c41ad",
"asset_id": "asset_2a91fc",
"kind": "transcript",
"start_seconds": 768,
"end_seconds": 794,
"quote": "Scaling laws still hold if you look at loss, not benchmarks.",
"locators": [
{
"type": "cloud",
"url": "https://api.cerul.ai/artifacts/artifact_7c41ad"
}
]
}
}
]
}エンドポイント
POST
/videos動画ファイルをアップロード
GET
/videos/{video_id}検索可能かどうかを確認
POST
/search意味で検索し、タイムコード付き evidence を返す
POST
/clips該当の瞬間からクリップを書き出す
4 ステップのフロー
アップロード、処理、証拠の検索、クリップの書き出し。各ステップの状態を追跡できます。
アップロード先を取得
直接アップロード先を取得し、返されたヘッダーで正確なバイトを PUT します。
完了して待つ
アップロードを確定し、ready になるまでポーリングします。
検索 / クリップ
POST /search で証拠を取得し、POST /clips で書き出します。
現在の連携方法はファイルのアップロードです。URL インポートは本トライアルに含まれません。注釈には専用スコープが必要です。出力例は性能・品質の保証ではありません。