確認中...

設定

外部システムから本サービスを利用するためのAPI情報を確認できます

接続情報
外部システムからAPIを呼び出す際に使用する接続情報です。

ベースURL

APIキー

認証方法
全ての外部APIエンドポイントで X-API-Key ヘッダーが必要です。
X-API-Key: <YOUR_API_KEY>

環境変数 NOTEVIDEO_API_KEYS が未設定の場合、開発環境として認証がスキップされます。

エンドポイント一覧
ベースURL以降のパスです。全リクエストに X-API-Key ヘッダーが必要です。
POST
/jobs— 動画生成ジョブ作成

CSVファイルをBase64またはサーバーパスで指定し、動画生成ジョブを作成します。ジョブIDを即時返却し、バックグラウンドで処理を開始します。

GET
/jobs— ジョブ一覧取得

全ジョブの一覧を返します。?status=processing などでフィルタリングできます。

GET
/jobs/{id}— ジョブ状態取得

指定ジョブの現在の状態を返します。status フィールドは pending / processing / completed / error のいずれかです。

GET
/jobs/{id}/download— 動画ダウンロード

完了したジョブのMP4動画をダウンロードします。S3有効時は署名付きURLへリダイレクトします。

POST
/audio-jobs— 音声ジョブ作成

CSVからGemini TTSを使って音声解説（WAV）を生成するジョブを作成します。

GET
/audio-jobs/{id}— 音声ジョブ状態取得

指定した音声ジョブの現在の状態を返します。completed になると generatedScript フィールドに解説原稿が含まれます。

GET
/audio-jobs/{id}/download— 音声ダウンロード

完了した音声ジョブのWAVファイルをダウンロードします。

cURL サンプル
コピーしてすぐに試せるリクエスト例です。

動画生成ジョブ作成

curl -X POST "http://localhost:8000/api/v1/jobs" \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "notebook_title": "月次レポート",
    "instructions": "CSVデータの主要な傾向を解説してください",
    "style": "whiteboard",
    "format": "explainer",
    "language": "ja",
    "csv_files": [
      {
        "filename": "report.csv",
        "content_base64": "<BASE64_ENCODED_CSV>"
      }
    ]
  }'

ジョブ状態確認

curl "http://localhost:8000/api/v1/jobs/{job_id}" \
  -H "X-API-Key: <YOUR_API_KEY>"

音声ジョブ作成

curl -X POST "http://localhost:8000/api/v1/audio-jobs" \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "CSV音声解説",
    "instructions": "データの傾向を音声で解説してください",
    "voice_name": "Kore",
    "language": "ja",
    "csv_files": [
      {
        "filename": "data.csv",
        "content_base64": "<BASE64_ENCODED_CSV>"
      }
    ]
  }'