音声を生成
ShareAIエンドポイントは制限されたJSONオーディオ結果を返します。.
このページについて
https://api.shareai.now/api/v1/audio/generations音声を生成
- ベースURL
https://api.shareai.now- 認証
- Bearer APIキーまたは承認済みOAuthアクセストークン
- 必須スコープ
inferenceormonetization_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
}'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);リクエストフィールド#
| フィールド | タイプ | 意味と制限 |
|---|---|---|
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日