Gerar áudio
O endpoint ShareAI retorna um resultado de áudio em JSON delimitado.
Nesta página
https://api.shareai.now/api/v1/audio/generationsGerar áudio
- URL Base
https://api.shareai.now- Autenticação
- Chave de API Bearer ou token de acesso OAuth aprovado
- Escopo necessário
inferenceormonetization_gateway
O endpoint ShareAI retorna um resultado de áudio em JSON delimitado. Pedidos de geração de áudio com modalities:["text","audio"] também podem usar /api/v1/chat/completions. O seu pedido é encaminhado para a operação de áudio declarada. Esta resposta síncrona é recolhida antes do retorno; fluxos incompletos de providers não se tornam resultados faturados com sucesso. Os formatos de saída de áudio são mp3, wav, flac, pcm16 ou pcm24, sujeitos ao modelo. PCM bruto não suporta uma tarifa baseada na duração. Defina max_tokens ou max_completion_tokens para delimitar os tokens gerados; não forneça ambos.
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/generations" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_AUDIO_MODEL',
'messages': [{'role': 'user', 'content': 'A short instrumental melody.'}],
'modalities': ['text', 'audio'],
'audio': {'format': 'mp3'},
'max_completion_tokens': 1024}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/generations', 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/generations", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_AUDIO_MODEL",
"messages": [
{
"role": "user",
"content": "A short instrumental melody."
}
],
"modalities": [
"text",
"audio"
],
"audio": {
"format": "mp3"
},
"max_completion_tokens": 1024
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);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. |
messages obrigatório | array | 1–256 mensagens de conversa com função/conteúdo. Use apenas modalidades de conteúdo suportadas pelo modelo de áudio selecionado. |
modalities | array | Um ou dois valores únicos de texto e áudio; áudio é obrigatório. O padrão é áudio. Este endpoint síncrono não aceita stream. |
audio | objeto | Opções de saída opcionais: apenas voz e formato. O formato pode ser mp3, wav, flac, pcm16 ou pcm24, sujeito ao suporte do modelo. PCM bruto é incompatível com tarifas baseadas na duração. |
temperature | número | Temperatura de geração suportada pelo modelo (opcional). |
top_p | número | Valor de amostragem nucleus suportado pelo modelo (opcional). |
max_tokens | inteiro | Limite opcional de tokens de saída, 1–262144. Não combine com max_completion_tokens. |
max_completion_tokens | inteiro | Limite opcional de tokens de saída, 1–262144. Não combine com max_tokens. |
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. O endpoint ShareAI retorna um resultado de áudio em JSON delimitado. Pedidos de geração de áudio com modalities:["text","audio"] também podem usar /api/v1/chat/completions. O seu pedido é encaminhado para a operação de áudio declarada. Esta resposta síncrona é recolhida antes do retorno; fluxos incompletos de providers não se tornam resultados faturados com sucesso. Os formatos de saída de áudio são mp3, wav, flac, pcm16 ou pcm24, sujeitos ao modelo. PCM bruto não suporta uma tarifa baseada na duração. Defina max_tokens ou max_completion_tokens para delimitar os tokens gerados; não forneça ambos.
Unidades de faturação#
Modelos de áudio podem publicar dimensões separadas de tokens de texto e tokens de áudio, duração, taxas de música ou de pedidos. Totais inclusivos de tokens são divididos em contadores distintos de texto/áudio; os mesmos tokens de áudio nunca são cobrados novamente como texto. Uso não suportado ou ausente não é aproximado a partir de bytes codificados.
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