Generar audio
El endpoint de ShareAI devuelve un resultado de audio en JSON delimitado.
En esta página
https://api.shareai.now/api/v1/audio/generationsGenerar audio
- URL base
https://api.shareai.now- Autenticación
- Clave API Bearer o token de acceso OAuth aprobado
- Alcance requerido
inferenceormonetization_gateway
El endpoint de ShareAI devuelve un resultado de audio en JSON delimitado. Las solicitudes de generación de audio con modalities:["text","audio"] también pueden usar /api/v1/chat/completions. Tu solicitud se enruta a la operación de audio declarada. Esta respuesta sincrónica se recopila antes de devolverse; las transmisiones incompletas de los proveedores no se consideran resultados facturados exitosos. Los formatos de salida de audio son mp3, wav, flac, pcm16 o pcm24, según el modelo. El PCM sin procesar no admite una tarifa por duración. Establece max_tokens o max_completion_tokens para delimitar los tokens generados; no suministres ambos.
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/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 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. |
messages requerido | matriz | 1–256 mensajes de conversación con rol/contenido. Usa solo modalidades de contenido compatibles con el modelo de audio seleccionado. |
modalities | matriz | Uno o dos valores únicos de texto y audio; el audio es obligatorio. Por defecto, se utiliza audio. Este endpoint sincrónico no acepta transmisión. |
audio | objeto | Opciones de salida opcionales: solo voz y formato. El formato puede ser mp3, wav, flac, pcm16 o pcm24, según la compatibilidad del modelo. El PCM sin procesar es incompatible con tarifas por duración. |
temperature | número | Temperatura opcional compatible con la generación del modelo. |
top_p | número | Valor opcional de muestreo núcleo compatible con el modelo. |
max_tokens | entero | Límite opcional de tokens de salida, 1–262144. No combinar con max_completion_tokens. |
max_completion_tokens | entero | Límite opcional de tokens de salida, 1–262144. No combinar con max_tokens. |
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 JSON. El endpoint de ShareAI devuelve un resultado de audio en JSON delimitado. Las solicitudes de generación de audio con modalities:["text","audio"] también pueden usar /api/v1/chat/completions. Tu solicitud se enruta a la operación de audio declarada. Esta respuesta sincrónica se recopila antes de devolverse; las transmisiones incompletas de los proveedores no se consideran resultados facturados exitosos. Los formatos de salida de audio son mp3, wav, flac, pcm16 o pcm24, según el modelo. El PCM sin procesar no admite una tarifa por duración. Establece max_tokens o max_completion_tokens para delimitar los tokens generados; no suministres ambos.
Unidades de facturación#
Los modelos de audio pueden publicar dimensiones separadas de tokens de texto y tokens de audio, duración, canción o tarifas de solicitud. Los totales de tokens inclusivos se dividen en contadores disjuntos de texto/audio; los mismos tokens de audio nunca se cobran nuevamente como texto. El uso no compatible o faltante no se aproxima a partir de bytes codificados.
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.