A API pública Speechdash está disponível

A API pública Speechdash está em api.speechdash.com/v1. Se constrói produtos em que é preciso ouvir texto, pode criar documentos e gerar voz sem abrir a interface do browser.

Este artigo resume o que está disponível, como funciona a faturação e como enviar o primeiro pedido em poucos minutos.

O que a API permite hoje

A API REST espelha a stack de escuta que já conhece da aplicação:

• Criar e gerir documentos na biblioteca Speechdash de um utilizador (importação de texto com título e idioma)
• Gerar voz com os presets Narrador, Questionador e Especialista em muchos idiomas
• Listar, ler, atualizar e eliminar documentos através de endpoints JSON previsíveis

Os documentos criados pela API aparecem na biblioteca em speechdash.com. Os seus utilizadores podem continuar a ouvir na app, editar texto, exportar áudio ou retomar noutro dispositivo.

A síntese vocal usa as mesmas vozes na nuvem que a reprodução na app. O consumo é debitado da carteira de créditos da conta, com as mesmas regras da escuta na nuvem no produto.

Para quem

As equipas recorrem à API quando a escuta deve viver dentro de outro produto:

• LMS e plataformas de estudo com leitura em voz alta em trabalhos ou artigos
• Camadas de acessibilidade em ferramentas SaaS
• Ferramentas internas que importam conteúdo em lote para revisão auditiva
• Protótipos que precisam de uma pré-visualização falada antes de uma interface completa

Se os seus utilizadores já têm conta Speechdash, mantêm uma carteira e uma biblioteca. A API é mais uma porta de entrada, não um produto separado.

Autenticação e documentação

Cada conta cria chaves de API em Definições → API em speechdash.com/settings/api. A chave é mostrada uma vez; no servidor guarda-se apenas um prefixo.

Envie Authorization: Bearer sh_live_… em cada pedido. Chaves inválidas ou revogadas recebem 401.

A documentação para programadores está no centro de ajuda:

• Visão geral da API (autenticação, limites, faturação, idempotência)
• Contrato OpenAPI em direto em api.speechdash.com/v1/openapi.json

A página de produto API pública resume a proposta para quem não programa na equipa.

Faturação em resumo

Os pedidos de voz retêm uma estimativa e depois ajustam à duração medida. Em novas tentativas pode enviar Idempotency-Key na criação de documentos e na síntese para evitar cobrança duplicada após falha de rede.

Os limites de taxa aplicam-se por conta (não por chave). As respostas incluem cabeçalhos habituais e Retry-After quando convém esperar.

Primeiro pedido em cinco minutos

1. Inicie sessão em speechdash.com e abra Definições → API
2. Crie uma chave e copie-a de imediato
3. Leia a visão geral da API
4. Faça POST com texto curto em /v1/documents ou chame /v1/audio/speech com preset de voz e idioma

Comece com duas frases antes de processar um capítulo inteiro. A visão geral lista campos exatos e exemplos de resposta.

Próximos passos

Vamos alargar a API conforme o produto evolui. Se integrar já, junte-se ao Discord para feedback antecipado ou abra o centro de ajuda se algo no contrato não estiver claro.

Obrigado por construir com Speechdash. Estamos curiosos para ver o que publica.

Guias relacionados

• Página funcionalidade API pública
• Começar com Speechdash
• Reprodução na nuvem
• Formatos de importação
• O que consome créditos