OpenAI · 音訊與音樂

OpenClaw x OpenAI TTS

OpenAI TTS 提供專門嘅文字轉語音模型,分別適合互動播放同專業旁白。透過 RunAPI,兩個 variant 共用同一個 request shape,並回傳由 RunAPI 管理嘅音訊 metadata。

2 variants 由 $0.02 / 1K UTF-8 位元組 可商用

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任務合適時使用 tts-1:低延遲語音合成,適用於互動應用。

You have access to RunAPI task tools for OpenAI TTS.

Available OpenAI TTS models:
- tts-1: 低延遲語音合成,適用於互動應用
  endpoints: /api/v1/openai_tts/text_to_speech
  request fields: model, text
- tts-1-hd: 較高質素的語音合成,適合精緻旁白
  endpoints: /api/v1/openai_tts/text_to_speech
  request fields: model, text

Use the model ID and endpoint that match the user's request.
Example prompt: 將呢段產品 onboarding 文稿轉成清晰自然嘅語音,用喺 app 內導覽。
/api/v1/openai_tts/text_to_speech: Submit the request and verify the synchronous output. POST /api/v1/openai_tts/text_to_speech。確認同步回應符合該端點的 API 參考。

公開版本與端點

模型 ID 端點 起始價格 模型目錄
tts-1
/api/v1/openai_tts/text_to_speech
$0.02 / 1K UTF-8 位元組 模型詳情
tts-1-hd
/api/v1/openai_tts/text_to_speech
$0.03 / 1K UTF-8 位元組 模型詳情

驗證

輪詢,直到 Task 進入終態

選擇 <model-id> 後產生驗證命令。

設定

指南端點: <endpoint>

選擇 <model-id> 後,依端點的公開輸入契約產生請求。
使用流程

三步開始使用

  1. 選擇模型 ID

    選擇公開模型 ID,並查看其端點與目前起始價格。

  2. 設定 RunAPI

    呼叫端點前設定 RUNAPI_API_KEY。

  3. 驗證結果

    對非同步端點輪詢同一路徑,直到 Task 進入終態。

使用 OpenClaw + OpenAI TTS 可以建立甚麼

  • 配音與旁白

    使用支援語音生成的模型,把腳本轉成影片、課程和產品示範所需的語音。

  • 音樂與配樂

    使用支援音樂生成的模型,根據曲風、情緒和節奏的描述製作背景音樂和廣告短曲。

  • 轉錄與音訊處理

    使用支援音訊輸入的模型,轉錄錄音,或清理、轉換現有音訊。

為甚麼透過 RunAPI + OpenClaw 使用 OpenAI TTS

  • 2 個變體,一個 API 金鑰

    透過一個 RunAPI 連線選擇可用的模型變體,無需更改現有整合。

  • 清晰的用量價格

    發送請求前查看目錄中的目前價格,無需訂閱或最低消費。

  • 直接返回結果

    同步調用會在同一個回應中返回結果,Agent 無需輪詢任務即可直接使用。

OpenClaw + OpenAI TTS 常見問題

tts-1 同 tts-1-hd 有咩分別?

tts-1 以低延遲為先,適合互動播放;tts-1-hd 就以更高音訊質素為先,適合旁白同完成版內容。

OpenAI TTS 會回傳咩音訊格式?

兩個 variant 都會喺 RunAPI response 回傳 MP3 音訊,以及格式、MIME type 同 byte size metadata。

生成音訊係咪由 RunAPI 管理?

係。RunAPI 會驗證音訊並回傳由 RunAPI 管理嘅 URL,唔會公開臨時來源 URL。

可以自訂聲線或語速嗎?

目前 endpoint 使用已公布嘅預設聲線同語速;自訂聲線同語速控制唔屬於呢個 endpoint contract。

文字轉語音係同步處理嗎?

係。request 成功後會直接回傳完整音訊結果,毋須使用另一個 polling endpoint。

應該使用哪個模型 ID?

從版本表選擇公開模型 ID。每個 ID 可用的端點均列於相應資料列。

本指南會設定聊天模型嗎?

不會。此 Model Line 使用頁面所示的端點流程,不會被描述為 Agent 聊天模型。

透過 OpenClaw 開始使用 OpenAI TTS

正在與團隊一起建立?

我們可以協助企業設定、整合和技術問題。

聯絡我們