VodScope
開発者インターフェース / v1

VodScope 開発者API

拡張機能、内部ツール、Premiereパネルから解析ジョブを作成できます。ダッシュボードAPIキーはvsk_で始まります。

01 / 認証
Authorization: Bearer vsk_your_api_key
02 / 解析を作成
POST /api/v1/analyses
Content-Type: application/json

{
  "video_url": "https://www.twitch.tv/videos/1234567890",
  "language": "ja"
}

202 Accepted
{
  "id": "master-job-id",
  "status": "processing",
  "required_credits": 2
}
03 / 解析一覧
GET /api/v1/analyses?completed=true&limit=20

{
  "analyses": [
    { "id": "master-job-id", "status": "completed" }
  ]
}
04 / 状態を取得
GET /api/v1/analyses/{id}

{
  "id": "master-job-id",
  "status": "completed",
  "points": [
    {
      "start_seconds": 123,
      "end_seconds": 168,
      "timestamp": "2:03",
      "title": "..."
    }
  ]
}
05 / Premiereパッケージ
GET /api/v1/analyses/{id}/premiere-package?fps=30
06 / Premiere送信キュー
Website:
POST /api/premiere/send

Premiere panel:
GET /api/v1/premiere-jobs
PATCH /api/v1/premiere-jobs/{jobId}
07 / 必要なSUPABASE SQL

サイトからPremiereへの送信キューを使う前に、一度実行してください。

CREATE TABLE IF NOT EXISTS premiere_send_jobs (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  user_id UUID NOT NULL REFERENCES auth.users(id) ON DELETE CASCADE,
  analysis_id UUID NOT NULL REFERENCES master_jobs(id) ON DELETE CASCADE,
  source_file_path TEXT,
  fps TEXT NOT NULL DEFAULT '30',
  status TEXT NOT NULL DEFAULT 'queued'
    CHECK (status IN ('queued', 'claimed', 'completed', 'failed')),
  claimed_at TIMESTAMPTZ,
  completed_at TIMESTAMPTZ,
  failed_at TIMESTAMPTZ,
  error TEXT,
  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

CREATE INDEX IF NOT EXISTS idx_premiere_send_jobs_user_status_created
  ON premiere_send_jobs (user_id, status, created_at DESC);

CREATE INDEX IF NOT EXISTS idx_premiere_send_jobs_analysis_id
  ON premiere_send_jobs (analysis_id);
キー管理

キーの作成・失効はダッシュボードから行えます。失効したキーは即時停止し、秘密キーの全文は作成時に一度だけ表示されます。

Developer API | VodScope