Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Suede x402 Media API

Suede exposes three public, machine-payable media products. Each route quotes its current price in an HTTP 402 Payment Required response and settles in USDC on Base.

Current public inventory

Verified against the live discovery document and unpaid 402 challenges on August 9, 2026.

Endpoint Product Price Atomic USDC
POST /create-music Full-length song generation $0.50 500000
POST /agent/video Short-form video generation $4.99 4990000
POST /agent/image Still-image generation $0.15 150000

Canonical discovery:

Both aliases publish the same three resources. If a route is not in that document, it is not a current public Suede media offering.

Read a quote without paying

curl -sS -X POST https://app.suedeai.ai/create-music \
  -H "content-type: application/json" \
  -d '{"prompt":"slow-burn desert rock, baritone vocal, tremolo guitar"}'

The server responds with x402 v2 terms including the atomic amount, accepted Base network identifier, USDC asset, current receiver, and timeout. This unpaid request does not spend funds.

Complete the x402 flow

  1. Send the intended request without payment.
  2. Read the exact terms from the 402 response.
  3. Sign an x402 v2 payment payload for one accepted requirement.
  4. Retry the identical request with PAYMENT-SIGNATURE.
  5. Read the result and settlement receipt.

Legacy X-PAYMENT callers remain supported during migration, but PAYMENT-SIGNATURE is the canonical header for new integrations.

Scope

  • /agent/generate is retired. Use /create-music.
  • Older /v1/* musician-tool profiles are not part of the current public three-product catalog.
  • Internal or unlisted routes used by other Suede systems are not public product listings.
  • Directory and documentation mirrors can lag. The live route challenge and well-known manifest win.
  • The current video price is $4.99.

The rendered reference lives at x402.suedeai.ai. Full page content is in index.md.

About

Suede x402 Music API: pay-per-call song generation, stems, mastering, and on-chain music rights. USDC on Base, no API key.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors