Generar voz
La respuesta exitosa es audio binario, no JSON.
En esta página
https://api.shareai.now/api/v1/audio/speechGenerar voz
- URL base
https://api.shareai.now- Autenticación
- Clave API Bearer o token de acceso OAuth aprobado
- Alcance requerido
inferenceormonetization_gateway
La respuesta exitosa es audio binario, no JSON. Guárdalo usando curl --output speech.mp3 o lee los bytes de respuesta en tu SDK. Elige una voz de modelo compatible y un formato de salida; la velocidad está limitada de 0.25 a 4. El límite de entrada es de 256 KiB y el límite de respuesta sincrónica es de 2 MiB.
Antes de comenzar#
Configure SHAREAI_API_KEY en su servidor y reemplace el marcador de posición del modelo con un modelo actualmente habilitado. Nunca exponga la clave API en el código del navegador. El modelo, la cuenta, las credenciales y el proveedor deben permitir esta operación. Las configuraciones opcionales a continuación requieren soporte del modelo; los límites de seguridad de la API no garantizan que todos los modelos admitan todos los valores.
Envía una solicitud#
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 de solicitud#
| Campo | Tipo | Significado y límites |
|---|---|---|
model requerido | cadena | Identificador exacto de modelo público habilitado. Debe declarar esta operación y estar permitido por sus credenciales. |
input requerido | cadena | Texto de habla requerido y no vacío, como máximo 256 KiB en UTF-8. Las tarifas por caracteres cuentan caracteres Unicode, no bytes codificados. |
voice | cadena | Voz opcional compatible con el modelo de habla seleccionado, como máximo 100 caracteres. |
response_format | cadena | Codificación de audio opcional compatible, como mp3. Una respuesta exitosa es binaria, no JSON. Las rutas con precios por duración necesitan MP3, WAV o FLAC autodescriptivos. |
speed | número | Velocidad de habla opcional de 0.25 a 4; el modelo puede imponer límites más estrechos. |
provider | objeto | Preferencias opcionales de enrutamiento del proveedor. Use provider.only para etiquetas de proveedor aceptadas, no como prefijo en el ID del modelo. Las restricciones de cuenta y credenciales aún se aplican. |
Leer el resultado#
El éxito devuelve HTTP 200 con audio binario. La respuesta exitosa es audio binario, no JSON. Guárdalo usando curl --output speech.mp3 o lee los bytes de respuesta en tu SDK. Elige una voz de modelo compatible y un formato de salida; la velocidad está limitada de 0.25 a 4. El límite de entrada es de 256 KiB y el límite de respuesta sincrónica es de 2 MiB.
Unidades de facturación#
El habla puede tener precios por carácter de entrada, token informado por el proveedor o segundo generado, dependiendo del modelo. Los conteos de caracteres usan caracteres Unicode. La tarificación por duración requiere un resultado MP3, WAV o FLAC autodescriptivo compatible. Un resultado PCM sin procesar no tiene una tasa de muestreo estimada. Las rutas con precios por token necesitan un recibo de uso confiable.
Elija el identificador exacto del modelo habilitado desde la Consola. Su operación declarada y capacidades de entrada/salida deben coincidir con este endpoint; un modelo de chat de texto no puede sustituirse por otra operación. Sus restricciones de credenciales, proveedor y cuenta aún se aplican.
Precios y uso#
Las tarifas se publican en créditos de IA en EUR para el modelo, proveedor, unidades y variantes seleccionados. Solo se cobran las dimensiones en su tarifa activa. Una estimación reserva créditos antes de la ejecución; los cargos finales usan el uso medido. Los precios pueden depender de la resolución, el formato de salida o una banda de uso. Consulte Uso en la Consola para el débito final de ShareAI. Los campos de costos ascendentes y bytes de medios no se convierten en recuentos de tokens inventados.
Acceso y errores#
Usar inference para inferencia aprobada con costo de red o monetization_gateway para un margen aprobado del Builder y términos de facturación aceptados. El acceso solo con identidad no autoriza gastos. La validación, autorización del modelo, créditos insuficientes, límites de tarifa y fallos de ejecución devuelven una error. estructura. Después de un tiempo de espera o envío incierto, inspeccione Uso o el trabajo de video antes de crear otra solicitud potencialmente pagada.
Última actualización noviembre 3, 2026.