ShareAI Platform Docs

Generate audio

The ShareAI endpoint returns a bounded JSON audio result.

View as Markdown
On this page
POST https://api.shareai.now/api/v1/audio/generations

Generate audio

Base URL
https://api.shareai.now
Authentication
Bearer API key or approved OAuth access token
Required scope
inference or monetization_gateway

The ShareAI endpoint returns a bounded JSON audio result. Audio-generating requests with modalities:["text","audio"] can also use /api/v1/chat/completions. Your request is routed to the declared audio operation. This synchronous response is collected before return; incomplete provider streams do not become successful billed results. Audio output formats are mp3, wav, flac, pcm16 or pcm24, subject to the model. Raw PCM cannot support a duration tariff. Set either max_tokens or max_completion_tokens to bound generated tokens; do not supply both.

Before you start#

Set SHAREAI_API_KEY on your server and replace the model placeholder with a currently enabled model. Never expose the API key in browser code. The model, account, credential and provider must all permit this operation. Optional settings below require model support; the API safety bounds are not a promise that every model supports every value.

Send a request#

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

Request fields#

FieldTypeMeaning and limits
model requiredstringExact enabled public model identifier. Must declare this operation and be allowed by your credential.
messages requiredarray1–256 conversation messages with role/content. Use only content modalities supported by the selected audio model.
modalitiesarrayOne or two unique values from text and audio; audio is required. Defaults to audio. This synchronous endpoint does not accept stream.
audioobjectOptional output options: voice and format only. format is mp3, wav, flac, pcm16 or pcm24, subject to model support. Raw PCM is incompatible with duration tariffs.
temperaturenumberOptional model-supported generation temperature.
top_pnumberOptional model-supported nucleus sampling value.
max_tokensintegerOptional output-token bound, 1–262144. Do not combine with max_completion_tokens.
max_completion_tokensintegerOptional output-token bound, 1–262144. Do not combine with max_tokens.
providerobjectOptional provider routing preferences. Use provider.only for accepted provider tags, not a prefix in the model ID. Account and credential restrictions still apply.

Read the result#

Success returns HTTP 200 with JSON. The ShareAI endpoint returns a bounded JSON audio result. Audio-generating requests with modalities:["text","audio"] can also use /api/v1/chat/completions. Your request is routed to the declared audio operation. This synchronous response is collected before return; incomplete provider streams do not become successful billed results. Audio output formats are mp3, wav, flac, pcm16 or pcm24, subject to the model. Raw PCM cannot support a duration tariff. Set either max_tokens or max_completion_tokens to bound generated tokens; do not supply both.

Billing units#

Audio models can publish separate text-token and audio-token dimensions, duration, song or request rates. Inclusive token totals are split into disjoint text/audio counters; the same audio tokens are never charged again as text. Unsupported or missing usage is not approximated from encoded bytes.

Choose the exact enabled model identifier from Console. Its declared operation and input/output capabilities must match this endpoint; a text chat model cannot be substituted for another operation. Your credential, provider and account restrictions still apply.

Pricing and usage#

Rates are published in EUR AI credits for the selected model, provider, units and variants. Only the dimensions in its active tariff are charged. An estimate reserves credits before execution; final charges use measured usage. Prices can depend on resolution, output format or a usage band. Check Console Usage for the final ShareAI debit. Upstream cost fields and media bytes are not converted into invented token counts.

Access and errors#

Use inference for approved network-cost inference or monetization_gateway for an approved Builder markup and accepted billing terms. Identity-only access does not authorize spending. Validation, model authorization, insufficient credits, rate limits and execution failures return a structured error. After a timeout or uncertain submission, inspect Usage or the video job before creating another potentially paid request.

Last updated November 3, 2026

ShareAI Platform Docs
All documentation

Search by title or content.

Ask about this page

Choose an assistant to explore this page. You can also copy the page and paste it into your conversation.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI