Gerar fala
A resposta bem-sucedida é áudio binário, não JSON.
Nesta página
https://api.shareai.now/api/v1/audio/speechGerar fala
- URL Base
https://api.shareai.now- Autenticação
- Chave de API Bearer ou token de acesso OAuth aprovado
- Escopo necessário
inferenceormonetization_gateway
A resposta bem-sucedida é áudio binário, não JSON. Guarde-o usando curl --output speech.mp3 ou leia os bytes da resposta no seu SDK. Escolha uma voz de modelo suportada e o formato de saída; a velocidade está limitada entre 0,25 e 4. O limite de entrada é de 256 KiB e o limite de resposta síncrona é de 2 MiB.
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/speech" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}' --output speech.mp3Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_SPEECH_MODEL',
'input': 'Hello from ShareAI.',
'response_format': 'mp3'}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/speech', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
with open("speech.mp3", "wb") as output:
output.write(response.read())TypeScript
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.shareai.now/api/v1/audio/speech", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}),
});
if (!response.ok) throw new Error(await response.text());
await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));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 obrigatório | string | Texto de fala obrigatório e não vazio, com no máximo 256 KiB em UTF-8. As tarifas por caracteres contam caracteres Unicode, não bytes codificados. |
voice | string | Voz opcional suportada pelo modelo de fala selecionado, com no máximo 100 caracteres. |
response_format | string | Codificação de áudio opcional suportada, como mp3. Uma resposta bem-sucedida é binária, não JSON. Rotas com preço por duração precisam de MP3, WAV ou FLAC autodescritivos. |
speed | número | Velocidade de fala opcional de 0,25 a 4; o modelo pode impor limites mais restritos. |
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#
O sucesso retorna HTTP 200 com áudio binário. A resposta bem-sucedida é áudio binário, não JSON. Guarde-o usando curl --output speech.mp3 ou leia os bytes da resposta no seu SDK. Escolha uma voz de modelo suportada e o formato de saída; a velocidade está limitada entre 0,25 e 4. O limite de entrada é de 256 KiB e o limite de resposta síncrona é de 2 MiB.
Unidades de faturação#
A fala pode ser tarifada por caractere de entrada, token reportado pelo fornecedor ou segundo gerado, dependendo do modelo. A contagem de caracteres usa caracteres Unicode. A tarifação por duração requer um resultado MP3, WAV ou FLAC autodescritivo suportado. Um resultado PCM bruto não possui taxa de amostragem estimada. Rotas tarifadas por token precisam de um recibo de uso confiável.
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