ShareAI Platform Docs

音声を生成

ShareAIエンドポイントは制限されたJSONオーディオ結果を返します。.

Markdownとして表示
このページについて
POST https://api.shareai.now/api/v1/audio/generations

音声を生成

ベースURL
https://api.shareai.now
認証
Bearer APIキーまたは承認済みOAuthアクセストークン
必須スコープ
inference or monetization_gateway

ShareAIエンドポイントは制限付きのJSONオーディオ結果を返します。オーディオ生成リクエストで modalities:["text","audio"] も使用できます /api/v1/chat/completions. 。リクエストは宣言されたオーディオ操作にルーティングされます。この同期レスポンスは返却前に収集されます。不完全なプロバイダーストリームは成功した請求結果にはなりません。オーディオ出力形式はmp3、wav、flac、pcm16またはpcm24で、モデルに依存します。生のPCMは期間料金をサポートできません。生成されるトークンを制限するためにmax_tokensまたはmax_completion_tokensのいずれかを設定してください。両方を指定しないでください。.

始める前に#

サーバーにSHAREAI_API_KEYを設定し、モデルプレースホルダーを現在有効なモデルに置き換えてください。APIキーをブラウザコードで公開しないでください。モデル、アカウント、資格情報、プロバイダーはすべてこの操作を許可する必要があります。以下のオプション設定はモデルのサポートが必要です。APIの安全範囲は、すべてのモデルがすべての値をサポートすることを保証するものではありません。.

リクエストを送信#

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

リクエストフィールド#

フィールドタイプ意味と制限
model 必須文字列有効な公開モデル識別子を正確に指定してください。この操作を宣言し、資格情報で許可されている必要があります。.
messages 必須配列1~256の会話メッセージ(役割/内容)。選択されたオーディオモデルがサポートするコンテンツモダリティのみを使用してください。.
modalities配列テキストとオーディオから1つまたは2つのユニークな値。オーディオは必須です。デフォルトはオーディオです。この同期エンドポイントはストリームを受け付けません。.
audioオブジェクトオプションの出力オプション:音声とフォーマットのみ。フォーマットはmp3、wav、flac、pcm16またはpcm24で、モデルのサポートに依存します。生のPCMは期間料金と互換性がありません。.
temperature数値モデルがサポートするオプションの生成温度。.
top_p数値モデルがサポートするオプションの核サンプリング値。.
max_tokens整数オプションの出力トークン制限、1~262144。max_completion_tokensと組み合わせないでください。.
max_completion_tokens整数オプションの出力トークン制限、1~262144。max_tokensと組み合わせないでください。.
providerオブジェクトオプションのプロバイダールーティング設定。プロバイダータグを受け入れる場合はprovider.onlyを使用してください。モデルIDのプレフィックスとして使用しないでください。アカウントと資格情報の制限は依然として適用されます。.

結果を読む#

成功するとHTTP 200が返され、JSONが返されます。ShareAIエンドポイントは制限付きのJSONオーディオ結果を返します。オーディオ生成リクエストで modalities:["text","audio"] も使用できます /api/v1/chat/completions. 。リクエストは宣言されたオーディオ操作にルーティングされます。この同期レスポンスは返却前に収集されます。不完全なプロバイダーストリームは成功した請求結果にはなりません。オーディオ出力形式はmp3、wav、flac、pcm16またはpcm24で、モデルに依存します。生のPCMは期間料金をサポートできません。生成されるトークンを制限するためにmax_tokensまたはmax_completion_tokensのいずれかを設定してください。両方を指定しないでください。.

請求単位#

オーディオモデルは、テキストトークンとオーディオトークンの次元、期間、曲またはリクエストレートを別々に公開できます。包括的なトークン合計は、テキスト/オーディオカウンターに分割されます。同じオーディオトークンがテキストとして再度請求されることはありません。サポートされていない使用や欠落した使用は、エンコードされたバイトから推定されません。.

Consoleから正確な有効モデル識別子を選択してください。その宣言された操作と入出力機能がこのエンドポイントに一致する必要があります。テキストチャットモデルを別の操作に代用することはできません。資格情報、プロバイダー、アカウントの制限は依然として適用されます。.

料金と使用状況#

料金は選択されたモデル、プロバイダー、単位、バリアントに対してEUR AIクレジットで公開されます。そのアクティブな料金の次元のみが請求されます。見積もりは実行前にクレジットを予約します。最終的な請求は測定された使用量を使用します。料金は解像度、出力形式、または使用帯域によって異なる場合があります。最終的なShareAIのデビットはConsole Usageで確認してください。上流のコストフィールドやメディアバイトは、発明されたトークン数に変換されません。.

アクセスとエラー#

使用する inference 承認されたネットワークコスト推論または monetization_gateway 承認されたBuilderのマークアップおよび受け入れられた請求条件に基づきます。アイデンティティのみのアクセスでは支出は許可されません。検証、モデル認証、不足クレジット、レート制限、実行失敗は構造化された error. タイムアウトや送信の不確実性が発生した場合、別の有料リクエストを作成する前にUsageまたはビデオジョブを確認してください。.

最終更新日 2026年11月3日

ShareAIプラットフォームドキュメント
すべてのドキュメント

タイトルまたは内容で検索してください。

このページについて質問する

このページを探索するためのアシスタントを選択してください。または、ページをコピーして会話に貼り付けることもできます。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI