Generate an original music track (Lyria 3), paid with x402

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.

post/api/x402/music

Request

  • Base URL: https://www.trezalabs.com
  • URL: https://www.trezalabs.com/api/x402/music
  • Auth: HTTP bearer

Headers

Preferstring

Optional. respond-async answers at once (200, status running) with a statusUrl to poll, like "async": true. wait=N sets how long the call waits, in seconds (default 45, at most 720), before it ends with status running and the statusUrl. Echoed in Preference-Applied.

Request body

promptstring required

Genre, mood, instruments, tempo.

model'lyria-3-clip' | 'lyria-3-pro'
asyncboolean

true answers at once (200, status running) with a statusUrl to poll.

Response

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.

runIdstring
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.

startedAtstring date-time
finishedAtstring date-time
durationMsinteger
audiostring uri

URL of the finished track. Use it exactly as given: its query parameters, including c=, are part of it.

statusUrlstring 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.

pollAfterMsinteger

Only when status is running: how long to wait before polling statusUrl.

paidUsdnumber

What this request cost.

modelstring
networkstring

Where the payment settled: eip155:8453 (Base) or solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp (Solana).

transactionstring

The settled payment: a 0x transaction hash on Base, a base58 transaction signature on Solana.

payerstring

The paying wallet.

errorstring

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.

retryableboolean

Failed runs only. True until the run's one free retry has been used.

retryUrlstring uri

Failed runs only. POST here to try again on the wallet balance, optionally with {"prompt": "..."} in the body. Carries the same signed ticket.

messagestring

Failed runs only. What happened and what to do, in one sentence.

balanceUsdnumber

Failed runs only. The wallet balance the retry spends.

Example response

{
  "status": "success"
}

Changes

No recorded changes to this operation across all 1 revision of this API.