Running Locally¶

Purpose¶

Use this flow when you want to run the HTTP service against local inputs and write outputs under .artifacts/output.

Prerequisites¶

FFmpeg on PATH
Bento4 tools on PATH
Rust toolchain available

Start The Service¶

cargo run -p service-http

The default config file is config/service.toml.

Verify The Service¶

curl -i http://localhost:8080/v2/health

Expected result: 200 OK with an empty body.

Run A Local Sync Request¶

curl -X POST http://localhost:8080/v2/sync/c2pa/video \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      {
        "type": "local_file_path",
        "path": "./tests/fixtures/video/mp4/video1.mp4"
      }
    ],
    "params": {},
    "output": {
      "type": "local",
      "name": "signed-videos"
    }
  }'

Outputs¶

Outputs are written under output_sinks.local.base_dir, composed as base_dir / output.prefix / output.name / <per-input-leaf> (here ./.artifacts/output/signed-videos/video1_c2pa.mp4)
The checked-in default base_dir is ./.artifacts/output
Omit output to write directly under base_dir; to keep the input filename instead of the _c2pa suffix, set output_sinks.local.naming = "in_place" in the service config (it is not a request field)