Transcrever áudio
Forneça áudio em base64 em input_audio.data e no seu formato real.
Nesta página
https://api.shareai.now/api/v1/audio/transcriptionsTranscrever áudio
- URL Base
https://api.shareai.now- Autenticação
- Chave de API Bearer ou token de acesso OAuth aprovado
- Escopo necessário
inferenceormonetization_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"
}
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_TRANSCRIPTION_MODEL',
'input_audio': {'data': 'UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
'format': 'wav'}}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/transcriptions', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/audio/transcriptions", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_TRANSCRIPTION_MODEL",
"input_audio": {
"data": "UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"format": "wav"
}
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);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#
| Campo | Tipo | Significado e limites |
|---|---|---|
model obrigatório | string | Identificador exato do modelo público ativado. Deve declarar esta operação e ser permitido pela sua credencial. |
input_audio obrigatório | objeto | Campos 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. |
language | string | Código de idioma opcional suportado pelo modelo. |
prompt | string | Contexto de transcrição opcional suportado pelo modelo; não é um prompt de geração de áudio. |
response_format | string | Formato de resposta suportado pelo modelo, com no máximo 100 caracteres. A operação determina se o resultado é JSON ou binário. |
timestamp_granularities | array | Valores opcionais de granularidade de timestamp suportados pelo modelo. A disponibilidade depende do formato de resposta e do modelo. |
provider | objeto | Preferê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