Suede AI developer docs for programmable IP
Suede AI developer docs explain the public interfaces, rights concepts, and agent-commerce discovery surfaces in the Suede ecosystem. The canonical documentation is maintained in the Suede-AI/suede-docs repository on GitHub.
API guides: pay-per-call endpoints
Suede sells music, video and image generation per call over x402, paid in USDC on Base with no account or API key. These guides cover the full integration, checked against the live API on 2026-10-11. For prices and request fields, the live discovery documents on app.suedeai.ai are the source of truth, and each guide links the documents it was checked against.
- Quickstart: send a request, read the 402 challenge, sign an EIP-3009 USDC authorization, retry with
PAYMENT-SIGNATURE, and poll for the result. - Endpoints: the three paid endpoints, their prices, shared payment terms, request headers and asynchronous mode.
- Create Music:
POST /create-music, a full original song from a prompt, $0.50. - Agent Video:
POST /agent/video, an 8-second 720p clip with native audio, $4.99. - Agent Image:
POST /agent/image, one PNG or JPEG, $0.15. - Errors and limits: status codes, error bodies, rate limits, idempotency and versioning.
- Python SDK:
pip install suede-ai, a client that signs and retries the payment for you. - Discovery and MCP: the x402 manifest, OpenAPI spec, catalog, A2A agent card and MCP server.
What is Suede AI?
Suede AI, also known as Suede Labs AI, is a company founded in 2024 by Jason Colapietro and based in West Palm Beach, Florida. Its official company website is suedeai.ai, and its SEO and AEO practice is Suede AI SEO. These developer docs cover the company's creator products, programmable IP, provenance, rights metadata, licensing workflows, and agent-commerce interfaces, including x402 and ACP discovery surfaces.
What are Suede's core pillars?
- Programmable IP: interfaces for recording provenance, rights metadata, and machine-readable usage terms.
- Creator ownership: documentation for connecting creative work to creator-supplied identity and rights context.
- Provenance: source and metadata records that help people and software inspect where a media asset came from.
- Licensing: documented workflows for publishing terms and reviewing license activity.
- Agent commerce: public x402 and ACP discovery files that describe available services and current prices.
Who maintains the public docs?
Suede AI maintains this index and the canonical docs repository. For current leadership background, see Jason Colapietro's public profile.
Where do the full developer docs live?
The canonical, most current public documentation is maintained on GitHub at Suede-AI/suede-docs: full product directory, x402/ACP endpoint table, token references, and language guide. This page mirrors the core facts; the GitHub README is the source of truth.
Read the full docs on GitHubWhat does Suede expose for AI agents (x402/ACP)?
Suede publishes public x402 and ACP discovery surfaces for agent-callable media and rights services. Use the live agent-commerce catalog for current availability and prices, and the x402 discovery document for machine-readable routes.
On 2026-10-11 the catalog held three endpoints, each paid per call in USDC on Base: Create Music at $0.50, Agent Video at $4.99 and Agent Image at $0.15. The same offerings are published as an OpenAPI spec, an A2A agent card and an MCP server; the discovery guide lists every format.
Where can I browse Suede sites and apps?
The Suede Universe Map is a plain-English directory of public Suede sites, apps, and endpoints. For the practice behind Suede's AI visibility work, and the method published in full, see Suede SEO.
Notes from the Suede AI team
Longer write-ups from Jason Colapietro and the Suede AI team in West Palm Beach, Florida, on how these docs are built and what agencies can take from them.
- Writing developer docs that AI assistants quote correctly: the source, date and verification rules behind this site.
- Model Context Protocol for agencies: a South Florida primer built around the Suede MCP server.
- From open source to docs: lessons from 54 merged pull requests across 46 repositories.
- An API documentation checklist for agency-built integrations: what a South Florida agency should document before handing off a client integration.
- Writing llms.txt that answer engines actually use: a worked example built from this site's own file.
All notes live in the notes index.
Related Suede tools for x402 sellers
- AI Agent Builder & Workflow Automation: build AI agents visually for leads, invoices and reports. Test workflows, inspect every run, and publish paid x402 APIs when payments are enabled.
- Suede ACP/x402 Performance Engine: score your ACP/x402 readiness in 60 seconds. Free, no account required.
- Agentix: x402 AI Agent Earnings Tracker for USDC on Base: the portfolio tracker for the x402 agents you've launched, with total USDC earned on Base, calls, per-agent performance, status, and trend.
Not what you were looking for? Go straight to the GitHub repo. Part of the Suede Universe Map.