Create Predict

Create and execute a prediction-only job. Distinct from /pipeline: runs prediction (and the minimum upstream prep, if needed), but exposes a separate session lifecycle and result endpoints. Use /pipeline for the full classify/apply flow.

Two input modes (auto-detected at job start):

• Mode A — dataset already prepared. Triggered when dataset_path points at a readable dataset.jsonl, or when an existing session_id already has cache/dataset/dataset.jsonl. Only the predict step runs.
• Mode B — USD upload / s3_uri / fresh session_id. When no prepared dataset is present, /predict runs the minimum upstream steps (optimize_usd if enabled → identify_asset → build_dataset_usd → build_dataset_prepare_dataset) before predicting. apply_physics is intentionally not part of /predict — use POST /pipeline if you need the full classify/apply flow.

The detected mode is persisted to session metadata under predict_mode and surfaced in the GET /predict/{id}/results response.