Media routes live under /v1/inference/media. Every successful artifact is
stored before it is returned, and responses contain Meridian durable URLs
rather than expiring upstream links.
Generation
POST /images and /images/edits: synchronous x402. Send an
Idempotency-Key; obtain the provider challenge, sign, and retry.
POST /video and /music: asynchronous fixed-price x402. The paid retry
returns 202 with a jobId.
GET /jobs/:id: authenticated job status and durable assets.
DELETE /jobs/:id: authenticated cancellation request. Refunds are driven
by the durable charge ledger only after cancellation/failure is confirmed.
Video/music are capability-gated and may be unavailable while image
generation is live.
Library
GET /library?kind=&cursor=&limit=
GET /assets/:id
DELETE /assets/:id
Library and job routes require:
X-Buyer-Address
X-Buyer-Signature
X-Buyer-Nonce
X-Buyer-Issued-At
X-Buyer-Expires-At
The signature binds the API domain, buyer, method, exact path, nonce, and
short validity window. Nonces are single-use.
Image response
Object URLs are public capability URLs. Keep them private if the generated
content is private. Deleting an asset removes the object and purges its CDN
cache, but anyone who already downloaded it retains that copy.