生成音頻
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 其中一個嚟限制生成嘅 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 | 陣列 | 一個或兩個來自文本同音頻嘅唯一值;音頻係必需嘅。默認係音頻。呢個同步端點唔接受流。. |
audio | 對象 | 可選輸出選項:僅限聲音同格式。格式包括 mp3、wav、flac、pcm16 或 pcm24,具體取決於模型支持。原始 PCM 唔兼容時長計費。. |
temperature | 數字 | 可選嘅模型支持嘅生成溫度。. |
top_p | 數字 | 可選嘅模型支持嘅核采樣值。. |
max_tokens | 整數 | 可選嘅輸出 token 限制,1–262144。唔好同 max_completion_tokens 一齊使用。. |
max_completion_tokens | 整數 | 可選嘅輸出 token 限制,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 其中一個嚟限制生成嘅 tokens;唔好同時提供兩個。.
計費單位#
音頻模型可以發佈獨立嘅文本 token 同音頻 token 維度、時長、歌曲或者請求速率。總 token 數會分為互不重疊嘅文本/音頻計數;相同嘅音頻 token 唔會再次作為文本收費。唔支持或者缺失嘅使用量唔會根據編碼字節估算。.
喺Console中選擇準確啟用嘅模型標識符。佢聲明嘅操作同輸入/輸出能力必須同呢個端點匹配;文字聊天模型唔可以用嚟代替其他操作。你嘅憑證、供應商同賬戶限制仍然適用。.
價格同使用量#
費率以歐元AI點數發佈,適用於所選模型、供應商、單位同變體。只會收取活躍費率中嘅維度。執行前嘅估算會預留點數;最終收費會根據實際使用量計算。價格可能取決於解析度、輸出格式或者使用量區間。喺Console Usage中檢查最終ShareAI扣款。上游成本字段同媒體字節唔會轉換成虛構嘅token數量。.
訪問同錯誤#
使用 inference 用於經批准嘅網絡成本推理或者 monetization_gateway 用於經批准嘅Builder加價同接受嘅計費條款。僅身份訪問唔授權支出。驗證、模型授權、點數不足、速率限制同執行失敗會返回結構化 error. 。喺超時或者提交不確定嘅情況下,檢查Usage或者視頻任務,然後先再創建另一個可能需要付費嘅請求。.
最後更新日期 2026 年 11 月 3 日