ShareAI Platform Docs

Generar audio

El endpoint de ShareAI devuelve un resultado de audio en JSON delimitado.

Ver como Markdown
En esta página
POST https://api.shareai.now/api/v1/audio/generations

Generar audio

URL base
https://api.shareai.now
Autenticación
Clave API Bearer o token de acceso OAuth aprobado
Alcance requerido
inference or monetization_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
}'

Campos de solicitud#

CampoTipoSignificado y límites
model requeridocadenaIdentificador exacto de modelo público habilitado. Debe declarar esta operación y estar permitido por sus credenciales.
messages requeridomatriz1–256 mensajes de conversación con rol/contenido. Usa solo modalidades de contenido compatibles con el modelo de audio seleccionado.
modalitiesmatrizUno 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.
audioobjetoOpciones 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.
temperaturenúmeroTemperatura opcional compatible con la generación del modelo.
top_pnúmeroValor opcional de muestreo núcleo compatible con el modelo.
max_tokensenteroLímite opcional de tokens de salida, 1–262144. No combinar con max_completion_tokens.
max_completion_tokensenteroLímite opcional de tokens de salida, 1–262144. No combinar con max_tokens.
providerobjetoPreferencias 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.

Documentación de la plataforma ShareAI
Toda la documentación

Buscar por título o contenido.

Preguntar sobre esta página

Elige un asistente para explorar esta página. También puedes copiar la página y pegarla en tu conversación.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI