{"openapi":"3.0.3","info":{"title":"Avila IA","version":"1.0.0","description":"Transcrição de áudio, leitura de documento e voz sintética rodando em servidor próprio no Brasil. Responde 200 com o resultado quando dá tempo e 202 com o id quando o trabalho é longo.","contact":{"name":"Avila Ops","url":"https://avilaops.com"}},"servers":[{"url":"https://ia.avilaops.com"}],"security":[{"chaveApi":[]}],"tags":[{"name":"Trabalhos","description":"Enviar áudio, documento ou texto."},{"name":"Conta","description":"Consumo e cota."}],"paths":{"/api/v1/transcricoes":{"post":{"tags":["Trabalhos"],"summary":"Áudio vira texto","parameters":[{"name":"aguardar_ms","in":"query","schema":{"type":"integer","default":90000},"description":"Quanto esperar antes de devolver 202. Use 0 para não esperar."},{"name":"Idempotency-Key","in":"header","schema":{"type":"string"},"description":"Reenviar com a mesma chave devolve o mesmo trabalho, sem cobrar de novo."}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"arquivo":{"type":"string","format":"binary"},"idioma":{"type":"string","description":"Opcional. Sem isso, detecta sozinho."},"contexto":{"type":"string","description":"Termos do seu negócio que ajudam o modelo com nome próprio e jargão."},"extrair":{"type":"string","enum":["true","false"]}},"required":["arquivo"]}},"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"De onde baixar o arquivo."},"base64":{"type":"string","description":"O arquivo em base64 (aceita data URI)."},"idioma":{"type":"string"},"contexto":{"type":"string"},"extrair":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Pronto","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"tipo":{"type":"string","enum":["transcricao","documento","voz"]},"status":{"type":"string","enum":["fila","processando","concluido","erro"]},"resultado":{"type":"object","nullable":true},"erro":{"type":"string","nullable":true},"unidades":{"type":"integer","description":"Segundos de áudio, documentos ou caracteres."},"duracao_ms":{"type":"integer","nullable":true},"criado_em":{"type":"string","format":"date-time"},"concluido_em":{"type":"string","format":"date-time","nullable":true}}}}}},"202":{"description":"Ainda rodando","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"tipo":{"type":"string","enum":["transcricao","documento","voz"]},"status":{"type":"string","enum":["fila","processando","concluido","erro"]},"resultado":{"type":"object","nullable":true},"erro":{"type":"string","nullable":true},"unidades":{"type":"integer","description":"Segundos de áudio, documentos ou caracteres."},"duracao_ms":{"type":"integer","nullable":true},"criado_em":{"type":"string","format":"date-time"},"concluido_em":{"type":"string","format":"date-time","nullable":true}}}}}},"401":{"description":"Chave inválida"},"429":{"description":"Teto de segurança do mês atingido"}}}},"/api/v1/documentos":{"post":{"tags":["Trabalhos"],"summary":"Imagem ou PDF vira texto e campos","description":"Com `extrair: true` (plano Operação em diante) devolve também valor, data, CPF/CNPJ validados pelo dígito verificador, chave PIX e código de autenticação.","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"arquivo":{"type":"string","format":"binary"},"idioma":{"type":"string","description":"Opcional. Sem isso, detecta sozinho."},"contexto":{"type":"string","description":"Termos do seu negócio que ajudam o modelo com nome próprio e jargão."},"extrair":{"type":"string","enum":["true","false"]}},"required":["arquivo"]}},"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"De onde baixar o arquivo."},"base64":{"type":"string","description":"O arquivo em base64 (aceita data URI)."},"idioma":{"type":"string"},"contexto":{"type":"string"},"extrair":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Pronto","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"tipo":{"type":"string","enum":["transcricao","documento","voz"]},"status":{"type":"string","enum":["fila","processando","concluido","erro"]},"resultado":{"type":"object","nullable":true},"erro":{"type":"string","nullable":true},"unidades":{"type":"integer","description":"Segundos de áudio, documentos ou caracteres."},"duracao_ms":{"type":"integer","nullable":true},"criado_em":{"type":"string","format":"date-time"},"concluido_em":{"type":"string","format":"date-time","nullable":true}}}}}},"202":{"description":"Ainda rodando"}}}},"/api/v1/voz":{"post":{"tags":["Trabalhos"],"summary":"Texto vira áudio (plano Inteligência)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["texto"],"properties":{"texto":{"type":"string","maxLength":5000},"voz":{"type":"string","default":"pf_dora"},"velocidade":{"type":"number","default":1}}}}}},"responses":{"200":{"description":"Pronto; o áudio sai em audio_url."}}},"get":{"tags":["Trabalhos"],"summary":"Vozes disponíveis","responses":{"200":{"description":"Lista"}}}},"/api/v1/jobs/{id}":{"get":{"tags":["Trabalhos"],"summary":"Busca o resultado","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Trabalho","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"tipo":{"type":"string","enum":["transcricao","documento","voz"]},"status":{"type":"string","enum":["fila","processando","concluido","erro"]},"resultado":{"type":"object","nullable":true},"erro":{"type":"string","nullable":true},"unidades":{"type":"integer","description":"Segundos de áudio, documentos ou caracteres."},"duracao_ms":{"type":"integer","nullable":true},"criado_em":{"type":"string","format":"date-time"},"concluido_em":{"type":"string","format":"date-time","nullable":true}}}}}},"404":{"description":"Não é desta conta"}}}},"/api/v1/uso":{"get":{"tags":["Conta"],"summary":"Consumo do mês e previsão da fatura","responses":{"200":{"description":"Resumo"}}}},"/api/health":{"get":{"summary":"Saúde do serviço","security":[],"responses":{"200":{"description":"OK"}}}}},"components":{"securitySchemes":{"chaveApi":{"type":"http","scheme":"bearer","description":"Chave gerada no painel. `aik_test_…` responde com dado de exemplo e não gasta franquia; `aik_live_…` processa de verdade."}},"schemas":{"Erro":{"type":"object","properties":{"erro":{"type":"object","properties":{"codigo":{"type":"string"},"mensagem":{"type":"string"}}}}}}},"x-planos":[{"id":"escuta","nome":"Escuta","mensal_centavos":3900,"cotas":{"transcricao":6000,"documento":30,"voz":0},"excedente_centavos":{"transcricao":12,"documento":18,"voz":0}},{"id":"operacao","nome":"Operação","mensal_centavos":12900,"cotas":{"transcricao":60000,"documento":400,"voz":0},"excedente_centavos":{"transcricao":8,"documento":12,"voz":0}},{"id":"inteligencia","nome":"Inteligência","mensal_centavos":59900,"cotas":{"transcricao":360000,"documento":3000,"voz":500000},"excedente_centavos":{"transcricao":5,"documento":7,"voz":900}}]}