convez.ai
MCP ServerIntegração & APIsIntermediário
Suede-AI

Suede AI SDK Python

Suede-AI/suede-sdk-python

Geração de música e processamento de áudio com pagamento por uso em blockchain

Ver no GitHub
InicialPluginScore · de 0 a 100

SDK Python para integração com a plataforma Suede AI, oferecendo 17 endpoints de geração de música, separação de stems, transcrição MIDI, masterização e síntese de letras. Funciona com modelo de pagamento pay-per-call em USDC na rede Base, sem necessidade de API keys ou subscrições.

Instalação

$npx convez-ai Suede-AI/suede-sdk-python

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 semanas
Versão
v0.4.0
Issues abertas
0
Contribuidores
2

Casos de uso

  • Gerar música original para projetos criativos e agentes de IA
  • Separar stems de áudio (vocais, bateria, baixo, outros)
  • Transcrever áudio para MIDI e realizar masterização automática
  • Criar vídeos musicais curtos sincronizados

Veredito

SDK bem estruturado para integrar geração de música on-demand em aplicações. O modelo pay-per-call em blockchain elimina friction de subscrições, mas exige wallet com USDC em Base. Ideal para agentes e pipelines criativos que precisam de áudio procedural.

README

A tradução para o português deste README ainda está na fila.

suede-ai

PyPI PyPI - Python Version PyPI - Downloads License: MIT x402

Python SDK for Suede AI — x402 pay-per-call music generation, stem splitting, MIDI transcription, mastering, lyric sync, and IP-registry lookups. 17 endpoints settled in USDC on Base. No API keys. No subscriptions. Sign an EIP-3009 authorization and call the endpoint.

The SDK wraps the 402-challenge / sign / retry loop so your agent code spends its time writing creative prompts, not encoding typed data.

Status: Alpha scaffold. Endpoint signatures track the live manifest at https://app.suedeai.ai/.well-known/x402.json. Once the OpenAPI spec covers all 17 endpoints, codegen will finish typing the request/response models.

Install

pip install suede-ai

Requires Python 3.10+. Pulls in httpx, eth-account, and pydantic.

60-second quickstart

from suede_ai import SuedeClient

# Funded EOA on Base with USDC. Treat this like any other secret.
PRIVATE_KEY = "0x..."

with SuedeClient(wallet_private_key=PRIVATE_KEY) as suede:
    track = suede.create_music(
        prompt="lo-fi rainy afternoon, vinyl crackle, soft piano",
        duration_seconds=30,
    )
    print(track["assetUrl"])      # https://cdn.suedeai.xyz/audio/trk_...mp3
    print(track["provenance"])    # {"fingerprint": "0x..."} — on-chain attestation

The first call returns 402 with the x402 challenge. The SDK signs an EIP-3009 transferWithAuthorization for USDC on Base, replays with X-PAYMENT, and returns the JSON body. You never touch the typed data.

The 17 endpoints

MethodEndpointPrice (USDC)What it does
create_musicPOST /create-music0.20Rights-aware music generation
agent_generatePOST /agent/generate0.20Agent-facing music output (same payload)
agent_videoPOST /agent/video1.50Short music-video clip generation
extendPOST /v1/extend0.40Continue an existing Suede track
coverPOST /v1/cover0.40Stylistic re-imagining of a track
voice_coverPOST /v1/vox0.40Replace lead vocal with a Suede voice
continue_trackPOST /v1/continue0.40Extend an uploaded audio file
stems_proPOST /v1/stems-pro0.404-stem split: vocals / drums / bass / other
stems_basicPOST /v1/stems0.202-stem split: vocals + instrumental
voxPOST /v1/acapella0.20Isolate the vocal stem
midiPOST /v1/midi0.10Transcribe audio to MIDI
wav_masterPOST /v1/mastering0.10High-quality WAV master
lyric_syncPOST /v1/lyric-sync0.10Timestamped lyrics for a track
lyricsPOST /v1/lyrics0.04Generate fresh song lyrics from a prompt
style_coachPOST /v1/style-coach0.02Expand short tags into a prompt-ready style brief
rights_lookupGET /v1/rights/{assetHash}0.005Suede Registry attestation lookup (owner / IP / NFT)
analyzePOST /v1/analyze0.003BPM / key / mode / energy / danceability

Prices are sourced from the live manifest at the time of writing and are enforced server-side.

How payment works

  1. Client calls POST /create-music.
  2. Server returns 402 Payment Required with a JSON accepts array. Each entry declares scheme (exact), network (eip155:8453), asset (USDC on Base), payTo address, and maxAmountRequired.
  3. SDK builds an EIP-3009 TransferWithAuthorization typed message and signs it with the configured wallet.
  4. SDK base64-encodes the payment payload and replays the original request with the X-PAYMENT header.
  5. Suede's facilitator settles on-chain; the response body returns asset URL + on-chain provenance.

You can inspect the live manifest yourself:

curl https://app.suedeai.ai/.well-known/x402.json | jq

Advanced

Reuse an httpx.Client

import httpx
from suede_ai import SuedeClient

http = httpx.Client(http2=True, timeout=120.0)
suede = SuedeClient(wallet_private_key=PRIVATE_KEY, http_client=http)

Direct call to any endpoint

result = suede.request("POST", "/v1/style-coach", json={"tags": "lofi, rainy"})

Inspect the live manifest

manifest = suede.manifest()  # free — no payment required

Roadmap

  • Async client (AsyncSuedeClient) once OpenAPI lands
  • Pydantic response models per endpoint
  • examples/ folder: LangChain tool wrappers, CrewAI tasks, agentcash adapter

See the 0.1.0 release checklist.

License

MIT. See LICENSE.


Built by Jason Colapietro · Suede Labs AI · x402 manifest


About the Author

Jason Colapietro is the founder and CEO of Suede Labs AI, a published author, and a Forbes contributor. He builds programmable IP and creator ownership infrastructure for AI-native media.

"The agents are already buying. x402 enables AI agents to pay for content, licenses, and generation at query time. If your IP isn't machine-readable and your licensing terms aren't programmable, you're invisible to the next distribution layer."

"Programmable IP is what happens when a licensing contract gets compressed into a format that agents can read at query time."

"On-chain registration doesn't replace copyright. It timestamps it. The law gives you ownership; the chain gives you proof."

Books:

Follow: X / @johnnysuede · suedeai.ai/founder

Ver o original no GitHub

Bom para

Relacionados