AI3D Benchmark Publisher Specification

Recommended app protocol

1. Hash the source image and resolve or explicitly select its benchmark.
2. POST publisher identity, generation manifest, and artifact declarations to /api/v1/deliverable-submissions.
3. Upload every artifact directly to the returned signed byte-range URLs and retain multipart ETags.
4. Complete each upload, start processing, and poll status until alignment is requested.
5. Submit alignment, canonical render, and metrics, then publish the immutable result.

Protocol guarantees

• Bearer credentials need the publish scope.
• Mutation retries are safe when the same Idempotency-Key is reused.
• Artifact size and SHA-256 are verified before processing.
• Signed URLs are temporary and must not be logged or persisted as public links.

Stable assets

• OpenAPI 3.1
• Publisher JSON Schema
• Generation Manifest JSON Schema
• Result Report JSON Schema
• App integration quickstart