Fala para texto para agentes de IA e vibe coders

Prompt pronto para copiar

Funciona com Cursor, Claude Code, Codex, Windsurf, Lovable, Replit, Bolt e v0. Esse prompt direciona o agente para a documentação feita para máquinas, garantindo o uso dos IDs de modelo e parâmetros certos.

Add speech-to-text to this app with the KolWrite API.
Read https://console.kolwrite.com/agent-instructions.md first.
- Key: process.env.KOLWRITE_API_KEY, sent as the x-api-key header (server side only).
- POST https://app.kolwrite.com/transcribe {"audio_url", "model": "oracle", "language": "auto", "output_format": "json"}
- Local files: POST /upload first, then use fileUrl as audio_url.
- Poll GET /transcribe/{jobId} every 5 s until COMPLETED or FAILED.
- Show result.segments (start, end, speaker, text).

Deixe salvo no projeto

Coloque esta linha no AGENTS.md, CLAUDE.md, .cursorrules ou nas regras de projeto da sua ferramenta. Assim, as próximas sessões já partem da mesma referência:

For speech-to-text, use the KolWrite API. Read https://console.kolwrite.com/agent-instructions.md and https://console.kolwrite.com/llms-full.txt before writing any code.

O que o agente vai fazer

1. Pegar a URL do arquivo (ou subir um arquivo local via POST /upload e usar o fileUrl).
2. Criar a tarefa com POST /transcribe e salvar o jobId.
3. Consultar GET /transcribe/{jobId} até o status mudar para COMPLETED, ou aguardar um webhook.
4. Mostrar o conteúdo de result.segments, que traz o texto, os tempos de início e fim e a identificação de quem está falando.

Exemplo da requisição mais simples possível (transformando uma nota de voz em texto puro):

curl https://app.kolwrite.com/transcribe \
  -H "x-api-key: $KOLWRITE_API_KEY" -H "Content-Type: application/json" \
  -d '{"audio_url": "https://example.com/voice-note.m4a", "model": "oracle_mini", "output_format": "txt"}'

O que dá para criar com os agentes

• Editar vídeo com agentes de IA: você passa a transcrição com a marcação de tempo de cada palavra, o agente escolhe os trechos e o ffmpeg devolve o corte pronto.
• API de legendas SRT: gere arquivos com output_format: "srt", traduza legendas, use WebVTT ou queime a legenda direto no vídeo com o ffmpeg.
• API de transcrição de reuniões: gravações com separação por participante, prontas para virar ata e lista de tarefas.
• API de carimbos de tempo por palavra: o segundo exato em que cada palavra começa e termina, ideal para criar clipes, fazer cortes e buscar termos.
• Ferramenta de transcrição para agentes de IA: definições prontas de ferramentas nos formatos da Anthropic e da OpenAI, além da regra para colocar no AGENTS.md.

Como gerar a chave de API

Agentes não conseguem criar conta sozinhos. Uma pessoa precisa acessar console.kolwrite.com/auth, abrir a conta, comprar créditos e gerar a chave na página de chaves de API. Depois, salve essa chave em uma variável de ambiente (KOLWRITE_API_KEY) ou no gerenciador de segredos da sua plataforma. Faça as chamadas à API sempre pelo backend ou por funções serverless, nunca direto do navegador.

Quanto custa

Cobramos por segundo, sem valor mínimo. Confira a tabela completa de preços em /llms/pricing.md.

Documentação para leitura por máquina

• llms.txt: indica qual chamada fazer e qual modelo escolher para cada tipo de tarefa.
• llms-full.txt: toda a documentação reunida em um único arquivo Markdown.
• openapi.json: especificação OpenAPI 3.1 para geradores de código e definição de ferramentas.
• agent-instructions.md: traz o prompt, os IDs dos modelos e os erros mais comuns para evitar.
• Qualquer página deste site também pode ser lida em Markdown. Basta colocar .md no final do endereço.

Perguntas e respostas