ForHosting KIT · Áudio e voz

Qual o bitrate desse áudio?

A leitura de metadados devolve a ficha técnica de um arquivo de áudio: duração, bitrate, taxa de amostragem, codec, canais e as tags de título e artista. Uma chamada, uma resposta estruturada — sem abrir programa de edição nem confiar no que o nome do arquivo promete.

● Estávelpor arquivoUS$ 0,077

Executar — US$ 0,077 + US$ 0,0045/arquivo Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Rode online

Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.

A ficha técnica que o arquivo esconde

Todo arquivo de áudio carrega, por dentro, a resposta às perguntas que o nome não responde: quanto dura de verdade, em que codec foi gravado, a que bitrate, em quantos canais, com que tags. Essa ficha técnica normalmente exige um programa de edição ou uma ferramenta de linha de comando para ser lida. Aqui ela vira uma chamada de API: entra o arquivo, sai a resposta estruturada — pronta para um script decidir o que fazer com aquele áudio.

Para que serve saber isso

Metadado é informação de decisão. Um sistema que aceita uploads precisa recusar o arquivo fora do padrão antes de armazenar, não depois. Uma emissora precisa conferir se o material entregue cumpre a exigência técnica do contrato. Um acervo só se organiza sabendo a duração e o formato de cada item. E há um uso contábil direto: como quase todo processamento de áudio cobra por minuto, ler a duração exata antes é a forma honesta de estimar o custo de qualquer lote.

Preço por arquivo e situação atual

Esta é a tarefa mais barata de operar da categoria: a cobrança é US$ 0,077 por chamada mais US$ 0,0045 por arquivo lido — a unidade aqui é o arquivo, não o minuto, porque ler a ficha técnica independe da duração. Aviso claro: a capacidade está em fase de implantação e ainda não aceita execuções; especificação e preço já estão publicados e serão os mesmos na abertura. Limites da categoria: 200 MB e 180 minutos por arquivo.

Casos de uso

Validar o upload antes de aceitar

Um app de mensagens de voz confere cada arquivo recebido: duração dentro do permitido, codec esperado, bitrate razoável. O que está fora do padrão é recusado na porta — e o suporte para de investigar áudio quebrado depois.

Conferir a entrega técnica da produtora

A rádio contratou spots com especificação definida em contrato. Antes de aprovar o lote, lê os metadados de cada arquivo entregue e confere bitrate e canais — a discussão com a produtora acaba em minutos, com dado na mesa.

Catalogar um acervo às cegas

Uma produtora herda um HD com milhares de gravações sem padrão de nome. Lendo os metadados de cada arquivo, monta a planilha do acervo — duração, formato, tags — sem abrir um áudio sequer no editor.

Estimar o custo antes de processar o lote

Antes de transcrever duzentas gravações, o sistema lê a duração exata de cada uma e calcula o orçamento do lote em centavos de precisão — decisão informada em vez de surpresa na fatura.

Perguntas frequentes

O que exatamente vem na resposta?

A ficha técnica do arquivo: duração, formato e codec, bitrate, taxa de amostragem, canais e as tags embutidas (como título e artista, quando existem). A resposta é estruturada, pensada para ser lida por código.

Serve para conferir muitos arquivos de uma vez?

É o cenário para o qual ela existe: por ser API, a leitura entra num laço do seu script e varre o acervo inteiro, arquivo por arquivo. A cobrança acompanha: US$ 0,0045 por arquivo processado, mais a chamada.

Por que aqui o preço é por arquivo e não por minuto?

Porque ler a ficha técnica custa o mesmo para um áudio de dez segundos ou de três horas — a duração não pesa na leitura. Por isso a unidade publicada é o arquivo: US$ 0,077 pela chamada mais US$ 0,0045 por arquivo.

Vocês alteram alguma coisa no meu arquivo?

Não — esta é uma operação somente de leitura. O arquivo entra, a ficha técnica sai e o conteúdo permanece intocado. Editar ou regravar tags é outro tipo de tarefa.

Consigo testar agora mesmo?

Por enquanto não: a capacidade está em fase de implantação e a execução ainda não abriu. O que você lê nesta página — especificação, limites, preço — é o que valerá na estreia, sem reajuste surpresa.

Ler os metadados exige enviar o áudio inteiro?

O arquivo é enviado para a leitura acontecer no servidor, e a resposta devolve apenas a ficha técnica. Nada do conteúdo é publicado. Se preferir entender em detalhe o tratamento dos dados, o atendimento responde antes do primeiro envio.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/audio/metadata

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/audio/metadata \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/audio/metadata", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/audio/metadata",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/audio/metadata", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/audio/metadata", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "input": "…"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "audio.metadata",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,077

por arquivoUS$ 0,0045

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

`max_mb`	200
`max_minutes`	180

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →