Execução
Transcrever um áudio
Transcreve uma gravação (multipart, campo file; tenant_id quando o chamador alcança mais de um cliente). Custa dinheiro e fala com a OpenAI, então um cliente bloqueado é recusado. O texto volta para quem pediu e não é gravado: é a fala de alguém, e guardá-la ninguém pediu.
Autorização
bearer runs:executeAutorizaçãoBearer <token>
Credencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: runs:execute
Corpo da requisição
multipart/form-data
multipart/form-data com o campo file e, opcionalmente, tenant_id
Definições TypeScript
Use o tipo request body no TypeScript.
Corpo da resposta
application/json
application/json
curl -X POST "https://<seu-servidor>/api/v3/transcriptions" \ -H "Authorization: Bearer <credencial>" \ -F "file=@./gravacao.wav"{ "language": "string", "model": "string", "text": "string"}