> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mrdn.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Durable Media

> Generate and retain images, video, and music

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

```json theme={"system"}
{
  "assets": [
    {
      "id": "4d2ab2c2-...",
      "kind": "image",
      "model": "venice-z-image-turbo",
      "prompt": "a green orbital station",
      "contentType": "image/png",
      "costUsdc": "12000",
      "createdAt": "2026-07-16T12:00:00Z",
      "url": "https://media.mrdn.finance/media/4d2ab2c2-....png"
    }
  ]
}
```

<Warning>
  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.
</Warning>