ShareAI Platform Docs

Transcrever áudio

Forneça áudio em base64 em input_audio.data e no seu formato real.

Ver como Markdown
Nesta página
POST https://api.shareai.now/api/v1/audio/transcriptions

Transcrever áudio

URL Base
https://api.shareai.now
Autenticação
Chave de API Bearer ou token de acesso OAuth aprovado
Escopo necessário
inference or monetization_gateway

Forneça áudio em base64 em input_audio.data e no seu formato real format. Os idiomas suportados, prompts, formatos de resposta e opções de timestamp dependem do modelo. Este endpoint JSON não aceita uploads de arquivos multipart. A resposta contém a transcrição e o uso reportado.

Antes de começar#

Defina SHAREAI_API_KEY no seu servidor e substitua o espaço reservado do modelo por um modelo atualmente ativado. Nunca exponha a chave da API no código do navegador. O modelo, conta, credencial e fornecedor devem permitir esta operação. As configurações opcionais abaixo requerem suporte do modelo; os limites de segurança da API não garantem que todos os modelos suportem todos os valores.

Enviar uma solicitação#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/transcriptions" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_TRANSCRIPTION_MODEL",
  "input_audio": {
    "data": "UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
    "format": "wav"
  }
}'

O exemplo contém um pequeno WAV silencioso apenas para demonstrar transporte válido em base64. Substitua input_audio.data pelo base64 padrão do seu próprio arquivo de áudio; para Python, use base64.b64encode(Path(“audio.wav”).read_bytes()).decode(“ascii”). Não cole uma URL de áudio neste campo.

Campos da solicitação#

CampoTipoSignificado e limites
model obrigatóriostringIdentificador exato do modelo público ativado. Deve declarar esta operação e ser permitido pela sua credencial.
input_audio obrigatórioobjetoCampos de dados e formatos obrigatórios. data é o base64 padrão dos bytes reais do áudio; format deve corresponder. Apenas JSON; multipart não é suportado. Tarifas de duração exigem WAV, MP3 ou FLAC com uma base de tempo conhecida, com no máximo 600 segundos combinados.
languagestringCódigo de idioma opcional suportado pelo modelo.
promptstringContexto de transcrição opcional suportado pelo modelo; não é um prompt de geração de áudio.
response_formatstringFormato de resposta suportado pelo modelo, com no máximo 100 caracteres. A operação determina se o resultado é JSON ou binário.
timestamp_granularitiesarrayValores opcionais de granularidade de timestamp suportados pelo modelo. A disponibilidade depende do formato de resposta e do modelo.
providerobjetoPreferências opcionais de roteamento do fornecedor. Utilize provider.only para etiquetas de fornecedor aceites, não como prefixo no ID do modelo. As restrições de conta e credencial ainda se aplicam.

Ler o resultado#

Sucesso retorna HTTP 200 com JSON. Forneça áudio em base64 em input_audio.data e no seu formato real format. Os idiomas suportados, prompts, formatos de resposta e opções de timestamp dependem do modelo. Este endpoint JSON não aceita uploads de arquivos multipart. A resposta contém a transcrição e o uso reportado.

Unidades de faturação#

A transcrição utiliza a duração publicada do modelo e/ou a tarifa por token. Os segundos e tokens reportados pelo Provider permanecem como medições separadas. O comprimento em base64 não é uma duração de áudio nem uma contagem de tokens. Tarifas baseadas na duração de entrada exigem WAV, MP3 ou FLAC autodescritivos com uma duração combinada de no máximo 600 segundos; bases de tempo desconhecidas ou PCM bruto não são admitidas para precificação por duração.

Escolha o identificador exato do modelo ativado no Console. A sua operação declarada e capacidades de entrada/saída devem corresponder a este endpoint; um modelo de chat de texto não pode ser substituído por outra operação. As restrições da sua credencial, fornecedor e conta ainda se aplicam.

Preços e utilização#

As tarifas são publicadas em créditos de IA em EUR para o modelo, fornecedor, unidades e variantes selecionados. Apenas as dimensões na sua tarifa ativa são cobradas. Uma estimativa reserva créditos antes da execução; os encargos finais utilizam a utilização medida. Os preços podem depender da resolução, formato de saída ou de uma faixa de utilização. Verifique a Utilização no Console para o débito final do ShareAI. Os campos de custo a montante e bytes de media não são convertidos em contagens de tokens inventadas.

Acesso e erros#

Uso inference para inferência aprovada de custo de rede ou monetization_gateway para uma margem aprovada do Builder e termos de faturação aceites. O acesso apenas por identidade não autoriza despesas. Validação, autorização de modelo, créditos insuficientes, limites de taxa e falhas de execução retornam uma estrutura error. Após um tempo limite ou submissão incerta, inspecione a Utilização ou o trabalho de vídeo antes de criar outro pedido potencialmente pago.

Última atualização 3 de Novembro de 2026

Documentação da Plataforma ShareAI
Toda a documentação

Pesquisar por título ou conteúdo.

Perguntar sobre esta página

Escolha um assistente para explorar esta página. Também pode copiar a página e colá-la na sua conversa.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI