W Studio - API & Integrações

MCP disponível: https://wstudios.app/mcp — autentique com sua API key (Authorization: Bearer) ou pelo login OAuth do site.

MCP — conecte seu assistente

Use ferramentas WStudios em clientes compatíveis com Model Context Protocol, sem compartilhar sua senha.

Streamable HTTP: https://wstudios.app/mcp

API key: crie uma chave acima e use Authorization: Bearer SUA_API_KEY. OAuth: adicione a URL no cliente, entre no WStudios em outra aba e autorize as permissões na página de consentimento. PKCE S256 obrigatório.

read: conta e catálogos; write: voz e áudio; music: geração musical. Consulta/download requer write por poder atualizar a tarefa. Revogue a chave dedicada em Suas API Keys para desconectar o aplicativo.

Ferramentas e exemplos

account_get {}: Saldo WStudios e plano da sua conta.
models_list {}: Modelos públicos disponíveis.
voices_list / voices_search / voice_get: Catálogo paginado. Exemplo: {"provider":"neural","page":1,"page_size":24}. voice_get também exige id.
jobs_list / jobs_get / srt_info: Indicam indisponibilidade: não há histórico/status puro nesta interface. Consulte SRT pela API pública.
generation_estimate: Orçamento sem débito para V4 e música. Exemplo: {"request":{"kind":"music","payload":{"provider":"musica","create_mode":"simple","idea":"Piano suave"}}}.
speech_generate / music_generate: Geração paga após aprovação humana. Use request, quote_id, payload_hash e max_credits do orçamento, mais confirmation: CONFIRM. Não retente aceite incerto.
job_get / job_download: Consulta e download limitado a 4 MB em base64. Exemplo: {"id":"ID_DA_TAREFA","refresh":true}. A API pode atualizar estado. Não use polling automático.

Exemplo de configuração (clientes que aceitam este formato)

{
  "mcpServers": {
    "wstudios": {
      "url": "https://wstudios.app/mcp",
      "headers": {"Authorization": "Bearer SUA_API_KEY"}
    }
  }
}

Nunca cole senha ou chave em conversas. Guarde a chave no cofre/configuração privada do cliente. Geração consome os mesmos créditos da API. Somente um journal persistente é suportado; não reenvie após timeout.

Documentação MCP · API v1

Suas API Keys

Use uma chave no header Authorization: Bearer <key> para chamar a API v1. Limite: 60 req/min por chave.

Rótulo	Prefixo	Criada	Última uso	Status
Carregando...

Uso recente

Chamadas autenticadas nos últimos 14 dias (v1 + webhooks).

0 chamadas no período —

Webhooks

Receba eventos (tts.completed, tts.failed, etc.) em uma URL. Cada payload vem assinado com X-WStudio-Signature (HMAC SHA-256).

URL	Eventos	Último disparo	Status
Carregando...

Documentação

Explore a referência OpenAPI interativa, copie exemplos de cURL e teste a API direto do navegador.

Abrir documentação (Swagger UI) ⬇ Baixar guia completo (para IA) Baixar spec (JSON)

Dica: baixe o guia completo e entregue o arquivo a qualquer IA (ChatGPT, Claude, etc.) pedindo para integrar a API no seu sistema — ele já contém tudo (endpoints, exemplos de código, webhooks e erros).

🎙️ Clonagem de voz

Crie vozes a partir de um MP3 e use direto no TTS — sem passar pelo painel.

curl -X POST "https://wstudios.pro/api/v1/voice-clone"   -H "Authorization: Bearer ***"   -F "file=@amostra.mp3"   -F "voice_name=Minha Voz 01"   -F "language_tag=Portuguese"   -F "gender_tag=female"   -F "model=minimax-fast"

A resposta traz voice_id e a voz já aparece em GET /api/v1/voices (provider=clone-fast). MP3 até 20 MB no minimax-fast e 5 MB no minimax-ultra. Não consome créditos.

🧪 Testar minha API

Valide sua chave e gere um áudio de teste aqui mesmo, sem precisar montar nada no seu sistema.

Usa a voz Christopher. Máximo 100 caracteres · 5 testes por dia · consome créditos da sua conta.

Playground

Cole um cURL e dispare contra a API. Usa a sua sessão de usuário (não a API key).