Skip to main content
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.