--- title: "Generate an original music track (Lyria 3), paid with x402" method: POST path: "/api/x402/music" --- # Generate an original music track (Lyria 3), paid with x402 `POST /api/x402/music` ## Request - Base URL: `https://www.trezalabs.com` - URL: `https://www.trezalabs.com/api/x402/music` - Auth: HTTP bearer Composes an original track from a description of genre, mood, instruments and tempo. lyria-3-clip: A 30-second piece: a bed for a short video, a sting, a loop. $0.06. lyria-3-pro: A full-length song with structure (intro, development, ending). $0.12. Pay via the x402 protocol (HTTP 402): call without payment to receive a 402 challenge carrying the price and networks, sign the payment with an x402-capable wallet, and retry with the payment-signature header. The challenge lists two ways to pay the same amount: USDC on Base (eip155:8453) first, then USDC on Solana mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp); a client pays the first one it has a wallet for, and neither needs gas money in the paying wallet. No account, API key, or signup is involved, so the payment is the only credential. A payment presented again after it was redeemed is refused with a 409 (code PAYMENT_ALREADY_REDEEMED). Only the documented fields are read; a request carrying any other field is refused with a 400 before any payment moves. The paid call answers 200 at once, with the statusUrl in the X-Status-Url header, then sends a whitespace byte every 2 seconds while it waits (JSON parsers ignore it), and ends with one complete JSON object. Read status in that body: success carries audio, the URL of the track; error means it failed, nothing was charged for it, and retryUrl tries again on the wallet balance the payment left, without paying twice; running means it outlasted the wait (45 seconds by default, Prefer: wait=N for up to 720), so poll statusUrl. Send "async": true or Prefer: respond-async for an immediate answer (200, status running) with a statusUrl. Lost the statusUrl? GET /api/x402/purchases and sign its challenge with the paying wallet (Sign-In-With-X, free) to list every purchase with its file and a fresh statusUrl. And the same request sent again from the same wallet, once the first render has finished and its file never reached you, is answered with that file (alreadyPaid, paidUsd 0) and the new payment is not taken. ## Headers - `Prefer` string ## Request body - object - `prompt` string, required: Genre, mood, instruments, tempo. - `model` 'lyria-3-clip' | 'lyria-3-pro' - `async` boolean: true answers at once (200, status running) with a statusUrl to poll. ## Response `200` Payment settled and the response waited for the track. Streamed: the status and headers are sent at once (X-Status-Url carries the statusUrl), then a whitespace byte every 2 seconds, then one complete JSON object. The HTTP status is 200 whatever happened, so read status in the body. - object - `runId` string - `status` 'success' | 'error' | 'partial' | 'cancelled' | 'running': success carries audio. error, partial, and cancelled carry the failure fields. running means it is still going; poll statusUrl. - `startedAt` string, date-time - `finishedAt` string, date-time - `durationMs` integer - `audio` string, uri: URL of the finished track. Use it exactly as given: its query parameters, including c=, are part of it. - `statusUrl` string, uri: The run's status, now and later. It carries its own signed claim ticket, so it needs no other credential. Use it exactly as given: the runId contains '#', encoded as %23. - `pollAfterMs` integer: Only when status is running: how long to wait before polling statusUrl. - `alreadyPaid` object: Only when this wallet already bought this exact request and its file never reached it: the earlier purchase this answer hands over (runId, boughtAt). The new payment was not taken and paidUsd is 0. - `runId` string - `boughtAt` string, date-time - `paidUsd` number: What this request cost. - `model` string - `network` string: Where the payment settled: eip155:8453 (Base) or solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp (Solana). - `transaction` string: The settled payment: a 0x transaction hash on Base, a base58 transaction signature on Solana. - `payer` string: The paying wallet. - `error` string: Failed runs only. What went wrong, in the provider's words. - `reason` 'prompt_refused' | 'render_failed': Failed runs only. prompt_refused: the model declined the prompt, so reword it. render_failed: it did not finish; the same prompt may succeed. - `retryable` boolean: Failed runs only. True until the run's one free retry has been used. - `retryUrl` string, uri: Failed runs only. POST here to try again on the wallet balance, optionally with {"prompt": "..."} in the body. Carries the same signed ticket. - `message` string: Failed runs only. What happened and what to do, in one sentence. - `balanceUsd` number: Failed runs only. The wallet balance the retry spends. ## Other responses - `400`: Missing or oversized prompt, a model that is not on the menu, or a field this endpoint does not read. Refused before settlement, so nothing was charged. - `402`: Payment required: the challenge response carrying x402 payment instructions - `409`: This payment was already redeemed (code PAYMENT_ALREADY_REDEEMED). Nothing new was generated or charged; send a new payment to buy another. - `429`: Rate limit exceeded - `503`: Pay-per-call music is not enabled on this deployment, or is temporarily unavailable. --- [API](https://skmtc.dev/trezalabs/apis/treza-pipelines-api.md) · [All operations](https://skmtc.dev/trezalabs/apis/treza-pipelines-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trezalabs/apis/treza-pipelines-api/revisions/a76574c1731b?raw)