JobOptions — ジョブの全オプション

POST /jobs と SDK の options に渡せる全フィールドの完全リファレンス — モード(fetch / codegen-loop / rerun)、Fetch 系(待機・スクロール・動画・Cookie)、プロファイル、AI、rerun ソース、min_asset_size_bytes、fetch_strategy、keep_session、ハブ注入フィールドまで。

POST /jobs のリクエスト body options（SDK では cli.fetch(url, **kwargs) の追加引数 / cli.session(url, options=...) の dict）に渡せる全フィールドの完全リファレンスです。SDK の型定義（server/protocol.py:JobOptions）と 1 対 1 です。

投入経路の概要は HTTP API、SDK の使い方は API リファレンス を参照。

早見表

モード

rerun_from と code は同時指定不可。両方ある場合は rerun_from が勝ちます。

Fetch 系（待機・スクロール）

mode: "fetch" のときに効きます。

動画 / アセット

ブラウザ

プロファイル / アタッチ

ログイン状態の持ち込み・既存ブラウザの再利用系。4 つは同時指定不可（最大 1 つ）。

AI（codegen-loop）

Fetch サブモード

AI 調査（管理画面の「AI で解析する」）は fetch_strategy の値ではなく、mode: "codegen-loop" で投入される別経路です。

セッション

使用例

Fetch（スクロール + 動画）

curl -X POST "$PAPRIKA_HUB/jobs" -H 'Content-Type: application/json' -d '{
  "url": "https://example.com",
  "options": {
    "mode": "fetch",
    "scroll": true,
    "scroll_max": 5000,
    "download_video": true,
    "min_asset_size_bytes": 2048
  }
}'

codegen-loop（AI 駆動）

curl -X POST "$PAPRIKA_HUB/jobs" -H 'Content-Type: application/json' -d '{
  "url": "https://example.com",
  "options": {
    "mode": "codegen-loop",
    "goal": "メイン動画を再生してダウンロードして保存して",
    "max_codegen_attempts": 3,
    "attempt_timeout_s": 600
  }
}'

rerun（保存済みスクリプトを再実行）

curl -X POST "$PAPRIKA_HUB/jobs" -H 'Content-Type: application/json' -d '{
  "url": "https://example.com",
  "options": {
    "mode": "rerun",
    "rerun_from": "abc123/attempts/2",
    "attempt_timeout_s": 600
  }
}'

keep_session（人手で続きを触る）

curl -X POST "$PAPRIKA_HUB/jobs" -H 'Content-Type: application/json' -d '{
  "url": "https://example.com",
  "options": {"mode": "fetch", "keep_session": true}
}'
# -> 終わったら session_id が JobInfo に残るので noVNC で開ける
# 終わったら明示的に閉じる:
curl -X DELETE "$PAPRIKA_HUB/sessions/<session_id>"

SDK からの渡し方

async with paprika() as cli:
    # cli.fetch はキーワード引数として options を受け取る
    job = await cli.fetch(
        "https://example.com",
        scroll=True,
        download_video=True,
        min_asset_size_bytes=2048,
    )

バリデーション

サーバ側で以下を強制します（違反は 422）。

• mode == "codegen-loop" → goal 必須
• mode == "rerun" → rerun_from か code のいずれか必須
• code ≤ 200 KB
• max_codegen_attempts: 1–10
• attempt_timeout_s: 30 – 864000（10 日）
• min_asset_size_bytes: ≥ 0
• download_video=true のとき capture_assets は自動で true に強制

関連

• HTTP API
• API リファレンス
• Hub の仕組み: 3 つのジョブモード
• 動画の仕組み
• Host レシピ / use_profile