OpenAI · 音訊與音樂

OpenClaw x OpenAI TTS

OpenAI TTS 提供專為互動播放與成品旁白設計的文字轉語音模型。在 RunAPI 中,兩個版本使用相同的請求格式,並回傳代管音訊的中繼資料。

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: 將這段產品導覽腳本轉成清晰自然的語音,供應用程式內的新手導覽使用。
/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 會回傳哪種音訊格式?

兩個版本都會在 RunAPI 回應中回傳 MP3 音訊,以及格式、MIME 類型和位元組大小等中繼資料。

生成的音訊由 RunAPI 代管嗎?

是。RunAPI 會驗證音訊並回傳代管 URL,不會公開暫時性的來源 URL。

可以選擇自訂語音或語速嗎?

目前端點採用已公布的預設語音與語速;自訂語音和語速控制不在此端點規格內。

文字轉語音是同步的嗎?

是。請求成功後會直接回傳完整的音訊結果,不需要透過另一個端點輪詢。

應該使用哪個模型 ID?

從版本表選擇公開模型 ID。每個 ID 可用的端點都列在對應資料列。

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

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

開始在 OpenClaw 中使用 OpenAI TTS

正在與團隊一起打造?

我們可以協助企業接入、整合與技術問題。

聯絡我們