ShareAI Platform Docs

Générer de l'audio

Le point de terminaison ShareAI renvoie un résultat audio JSON limité.

Voir en Markdown
Sur cette page
POST https://api.shareai.now/api/v1/audio/generations

Générer de l'audio

URL de base
https://api.shareai.now
Authentification
Clé API Bearer ou jeton d'accès OAuth approuvé
Portée requise
inference or monetization_gateway

Le point de terminaison ShareAI renvoie un résultat audio JSON limité. Les requêtes générant de l'audio avec modalities:["text","audio"] peuvent également utiliser /api/v1/chat/completions. Votre requête est acheminée vers l'opération audio déclarée. Cette réponse synchrone est collectée avant le retour ; les flux incomplets des fournisseurs ne deviennent pas des résultats facturés avec succès. Les formats de sortie audio sont mp3, wav, flac, pcm16 ou pcm24, selon le modèle. Le PCM brut ne peut pas prendre en charge un tarif basé sur la durée. Définissez soit max_tokens soit max_completion_tokens pour limiter les tokens générés ; ne fournissez pas les deux.

Avant de commencer#

Configurez SHAREAI_API_KEY sur votre serveur et remplacez l'espace réservé du modèle par un modèle actuellement activé. Ne jamais exposer la clé API dans le code du navigateur. Le modèle, le compte, les identifiants et le fournisseur doivent tous autoriser cette opération. Les paramètres optionnels ci-dessous nécessitent la prise en charge du modèle ; les limites de sécurité de l'API ne garantissent pas que chaque modèle prend en charge chaque valeur.

Envoyez une requête#

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
}'

Champs de la requête#

ChampTypeSignification et limites
model requischaîneIdentifiant exact du modèle public activé. Doit déclarer cette opération et être autorisé par vos identifiants.
messages requistableau1 à 256 messages de conversation avec rôle/contenu. Utilisez uniquement les modalités de contenu prises en charge par le modèle audio sélectionné.
modalitiestableauUne ou deux valeurs uniques parmi texte et audio ; l'audio est requis. Par défaut, audio. Ce point de terminaison synchrone n'accepte pas les flux.
audioobjetOptions de sortie facultatives : uniquement voix et format. format est mp3, wav, flac, pcm16 ou pcm24, selon la prise en charge du modèle. Le PCM brut est incompatible avec les tarifs basés sur la durée.
temperaturenombreTempérature de génération facultative prise en charge par le modèle.
top_pnombreValeur de l'échantillonnage nucleus facultative prise en charge par le modèle.
max_tokensentierLimite facultative de tokens de sortie, 1 à 262144. Ne pas combiner avec max_completion_tokens.
max_completion_tokensentierLimite facultative de tokens de sortie, 1 à 262144. Ne pas combiner avec max_tokens.
providerobjetPréférences d'acheminement des fournisseurs facultatives. Utilisez provider.only pour les balises de fournisseurs acceptées, pas un préfixe dans l'ID du modèle. Les restrictions de compte et d'identifiants s'appliquent toujours.

Lire le résultat#

Succès renvoie HTTP 200 avec JSON. Le point de terminaison ShareAI renvoie un résultat audio JSON limité. Les requêtes générant de l'audio avec modalities:["text","audio"] peuvent également utiliser /api/v1/chat/completions. Votre requête est acheminée vers l'opération audio déclarée. Cette réponse synchrone est collectée avant le retour ; les flux incomplets des fournisseurs ne deviennent pas des résultats facturés avec succès. Les formats de sortie audio sont mp3, wav, flac, pcm16 ou pcm24, selon le modèle. Le PCM brut ne peut pas prendre en charge un tarif basé sur la durée. Définissez soit max_tokens soit max_completion_tokens pour limiter les tokens générés ; ne fournissez pas les deux.

Unités de facturation#

Les modèles audio peuvent publier des dimensions distinctes pour les tokens texte et audio, la durée, les taux de chanson ou de requête. Les totaux de tokens inclusifs sont répartis en compteurs texte/audio disjoints ; les mêmes tokens audio ne sont jamais facturés à nouveau comme texte. Les utilisations non prises en charge ou manquantes ne sont pas approximées à partir des octets encodés.

Choisissez l'identifiant exact du modèle activé depuis la Console. Son opération déclarée et ses capacités d'entrée/sortie doivent correspondre à ce point de terminaison ; un modèle de chat texte ne peut pas être substitué pour une autre opération. Vos restrictions d'identifiants, de fournisseur et de compte s'appliquent toujours.

Tarification et utilisation#

Les tarifs sont publiés en crédits IA EUR pour le modèle, le fournisseur, les unités et les variantes sélectionnés. Seules les dimensions de son tarif actif sont facturées. Une estimation réserve des crédits avant l'exécution ; les frais finaux sont basés sur l'utilisation mesurée. Les prix peuvent dépendre de la résolution, du format de sortie ou d'une tranche d'utilisation. Consultez l'onglet Utilisation dans la Console pour vérifier le débit final de ShareAI. Les champs de coûts en amont et les octets multimédias ne sont pas convertis en nombres de jetons inventés.

Accès et erreurs#

Utiliser inference pour une inférence approuvée avec coût réseau ou monetization_gateway pour une majoration approuvée par le Builder et des conditions de facturation acceptées. Un accès basé uniquement sur l'identité n'autorise pas les dépenses. La validation, l'autorisation du modèle, les crédits insuffisants, les limites de taux et les échecs d'exécution renvoient une structure error. Après un délai d'attente ou une soumission incertaine, vérifiez l'onglet Utilisation ou le travail vidéo avant de créer une autre demande potentiellement payante.

Dernière mise à jour le 3 novembre 2026

Documentation de la plateforme ShareAI
Toute la documentation

Rechercher par titre ou contenu.

Poser une question sur cette page

Choisissez un assistant pour explorer cette page. Vous pouvez également copier la page et la coller dans votre conversation.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI