Skip to content

Add Suede AI - rights-aware music & video generation (x402, Base)#439

Open
JasonColapietro wants to merge 3 commits into
xpaysh:mainfrom
JasonColapietro:add-suede-ai
Open

Add Suede AI - rights-aware music & video generation (x402, Base)#439
JasonColapietro wants to merge 3 commits into
xpaysh:mainfrom
JasonColapietro:add-suede-ai

Conversation

@JasonColapietro
Copy link
Copy Markdown

@JasonColapietro JasonColapietro commented May 26, 2026

Add Suede AI

What: Adds Suede AI to Example Applications > API Examples — a live, agent-payable creative IP service. Autonomous agents pay USDC on Base for music and short-video generation, plus 20+ supporting music-production and rights-lookup skills.

Why: Suede AI is one of the few media-generation endpoints in the x402 ecosystem, and the only one wired to on-chain IP provenance. Every output is fingerprinted and eligible for attestation through the Suede Registry on Base, so agents producing creative work get a portable rights anchor on top of the payment itself. Useful for any agent that needs licensed-by-default audio/video as part of its workflow.

Endpoints (selected from 22 live paid routes; 24 products in catalog):

  • POST /create-music — $0.20 USDC per track (200000 atomic units)
  • POST /agent/video — $1.50 USDC per clip (1500000 atomic units)
  • POST /agent/generate — $0.20 USDC, programmatic media generation through the IP stack

Full price list and routes: https://app.suedeai.ai/api/v1/catalog (canonical source — values mirror the x402 challenges).

Live verification:

Curl repro:

curl -i -X POST https://app.suedeai.ai/create-music \
  -H "Content-Type: application/json" \
  -d '{"prompt":"ambient lofi","durationSeconds":30}'
# -> HTTP/1.1 402 Payment Required + valid x402 challenge

Quality Checklist:

  • Resource is actively maintained (22 live paid endpoints + 2 free oracle reads in production)
  • Well-documented with discovery JSON + agent card published at standard well-known paths
  • Directly related to x402 protocol (native x402 v1 challenge schema, Coinbase facilitator)
  • Links working and accessible (verified HTTP 200 on x402, agent-card, and catalog endpoints)
  • Follows contribution format (- [Name](url) - Description., neutral tone, no emojis)
  • One resource per PR

Category: Example Applications > API Examples (added at the end, after agent-marketplace-proxy, alongside other media-generation entries like Obol, IteraTools, and TOUGH LOVE SECURITY ImageGen).

Provider: Suede Labs — https://suedeai.ai · Founder: Jason Colapietro (johnnysuedes@gmail.com)

JasonColapietro and others added 3 commits May 24, 2026 02:12
…aces

Catalog grew from 17 to 24 paid skills (music gen, video, stems pro, MIDI,
mastering, lyric sync, vocal isolation, rights lookup, prompt analysis,
rig analysis/oracle/roast). Adds Stripe ACP, Virtuals ACP, and agentic
commerce manifest links alongside the existing x402 + agent-card surfaces.
@JasonColapietro JasonColapietro marked this pull request as draft May 27, 2026 03:39
@JasonColapietro
Copy link
Copy Markdown
Author

Refreshed the API Examples entry: catalog has grown from 17 to 24 paid skills (stems-pro, MIDI, mastering, lyric sync, vocal isolation, rights lookup, prompt analysis, guitar rig analysis/oracle/roast added to the original music + video set). Added links to the agentic-commerce manifest and /api/v1/catalog index alongside the existing x402 + agent-card surfaces. Marking as draft for re-review.

@JasonColapietro JasonColapietro marked this pull request as ready for review May 27, 2026 03:58
@TateLyman
Copy link
Copy Markdown

Ran a no-payment external pass against the public Suede AI x402 surfaces. I did not send payment headers, sign requests, or attempt paid calls.

Repro:

curl -i https://app.suedeai.ai/.well-known/x402.json
curl -i https://app.suedeai.ai/api/v1/catalog
curl -i -X POST https://app.suedeai.ai/create-music \
  -H 'Origin: https://app.suedeai.ai' \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"ambient lofi","durationSeconds":30}'
curl -i -X OPTIONS https://app.suedeai.ai/create-music \
  -H 'Origin: https://chatgpt.com' \
  -H 'Access-Control-Request-Method: POST' \
  -H 'Access-Control-Request-Headers: content-type,x-payment'

What looks good:

  • /.well-known/x402.json and /.well-known/agent-card.json are live.
  • Sampled paid routes (/create-music, /agent/video, /agent/generate) return structured 402 before execution, with Base USDC, canonical resource URLs, Payment-Required, Cache-Control: no-store, and browser-readable payment headers for https://app.suedeai.ai.
  • /api/v1/catalog is live and exposes the 24-product catalog plus seller metadata.

Patch notes before merge:

  • P1: listing/manifest/catalog price and payee drift need one source of truth. The PR text still says $0.75 for music and $5.00 for video, while live x402 challenges show 200000 and 1500000 USDC units. Also, the x402 manifest/challenges use payTo 0xb5a05466712fd5bcdf2883f43cC6B1799428032d, while /api/v1/catalog payment metadata lists receiver 0x0e3557e4f662f9bca497611b60c95330de747a7d.
  • P2: x402-surface-check@latest could not auto-probe the manifest because the JSON is keyed as POST /route entries rather than a recognized manifest/OpenAPI/resource list shape. The routes work manually, but generic crawlers may miss them.
  • P2: browser preflight from https://chatgpt.com returns 400 while still including useful CORS allow headers. If cross-origin agent clients are intended, a clean 204/200 preflight would remove ambiguity.
  • P3: https://app.suedeai.ai/.well-known/agent.json is 404 while agent-card.json is live. That may be intentional for ERC-8004, but adding an alias or documenting the distinction would help generic agent crawlers.

@JasonColapietro
Copy link
Copy Markdown
Author

Quick check-in — happy to provide any additional info that would help with review. The 17-endpoint surface is live and stable: https://app.suedeai.ai/.well-known/x402.json, with curl repro below if useful for verification:

curl -i -X POST https://app.suedeai.ai/create-music \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"ambient lofi"}'

Returns a clean 402 challenge (USDC on Base, EIP-3009). Thanks for maintaining the list.

@JasonColapietro
Copy link
Copy Markdown
Author

Thanks for the pass — body updated to reflect the current 22-route surface and $0.20 / $1.50 pricing, with https://app.suedeai.ai/api/v1/catalog pinned as the canonical price source.

For the record: the catalog receiver matches the x402 payTo (0xb5a05466712fd5bcdf2883f43cC6B1799428032d) uniformly across all 22 paid routes — there is no separate 0x0e35…7a7d address in either surface. The price drift between the original PR text and the live challenges was real and is the fix that went into the updated body.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants