--- title: ElevenLabs 語音轉文字 | RunAPI description: 使用語音轉文字端點以建立非同步任務。 url: https://runapi.ai/zh-HK/docs/api/elevenlabs/speech-to-text.md canonical: https://runapi.ai/zh-HK/docs/api/elevenlabs/speech-to-text locale: zh-HK --- > HTML 版本: https://runapi.ai/zh-HK/docs/api/elevenlabs/speech-to-text > 智能代理網站索引: https://runapi.ai/llms.txt # ElevenLabs 語音轉文字 ## 概覽 使用語音轉文字端點配合所需輸入。使用返回的任務 ID 來檢索其狀態，或提供 callback_url 以接收以下記錄的推送通知。 ### 快速入門 1. 建立 API 金鑰並將其設定為 RUNAPI_API_KEY。 2. 傳送主體符合請求 Schema 的 POST 請求。 3. 儲存返回的任務 ID，然後輪詢直至達到終止狀態，或處理下方說明的回呼。 ## 端點 POST /api/v1/elevenlabs/speech_to_text 基礎 URL: https://runapi.ai API 版本: v1 身份驗證: Authorization: Bearer YOUR_API_TOKEN ## 支援的模型 開啟模型頁面以查看當前定價、速率限制及商業用途詳情。 - [speech-to-text](https://runapi.ai/zh-HK/models/elevenlabs/speech-to-text) ## 請求結構 僅傳送已記錄的欄位。提供後，callback_url 將接收以下記錄的任務交付。 ### speech-to-text ```json { "callback_url": { "type": "string" }, "diarize": { "type": "boolean" }, "language_code": { "type": "string" }, "source_audio_url": { "required": true, "type": "string" }, "tag_audio_events": { "type": "boolean" } } ``` ## 建立接受 HTTP 202 - POST /api/v1/elevenlabs/speech_to_text ### 回應結構 ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "id": { "type": "string" }, "status": { "enum": [ "processing" ], "type": "string" }, "task_replayed": { "type": "boolean" } }, "required": [ "id", "status", "billing" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "billing": { "refund": null, "reservation": null, "settlement": null }, "id": "tsk_reference_demo", "status": "processing" } ``` ## 輪詢處理中 HTTP 200 - GET /api/v1/elevenlabs/speech_to_text/:id ### 回應結構 ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "id": { "type": "string" }, "status": { "enum": [ "processing" ], "type": "string" } }, "required": [ "id", "status", "billing" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "billing": { "refund": null, "reservation": null, "settlement": null }, "id": "tsk_reference_demo", "status": "processing" } ``` ## 輪詢已完成 HTTP 200 - GET /api/v1/elevenlabs/speech_to_text/:id ### 回應結構 ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "id": { "type": "string" }, "status": { "enum": [ "completed" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "id", "status", "text", "billing" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "billing": { "refund": null, "reservation": null, "settlement": null }, "id": "tsk_reference_demo", "status": "completed", "text": "Welcome to RunAPI." } ``` ## 輪詢失敗 HTTP 200 - GET /api/v1/elevenlabs/speech_to_text/:id ### 回應結構 ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "type": "string" }, "id": { "type": "string" }, "status": { "enum": [ "failed" ], "type": "string" } }, "required": [ "id", "status", "error", "billing" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "billing": { "refund": null, "reservation": null, "settlement": null }, "error": "Task processing failed.", "id": "tsk_reference_demo", "status": "failed" } ``` ## 客戶回呼：已完成 HTTP 200 - POST callback_url ### 回應結構 ```json { "properties": { "id": { "type": "string" }, "status": { "enum": [ "completed" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "id", "status", "text" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "id": "tsk_reference_demo", "status": "completed", "text": "Welcome to RunAPI." } ``` ## 客戶回呼：已失敗 HTTP 200 - POST callback_url ### 回應結構 ```json { "properties": { "error": { "oneOf": [ { "type": "string" }, { "properties": { "code": { "type": "string" }, "limit_cents": { "type": "integer" }, "message": { "type": "string" }, "reset_at": { "format": "date-time", "type": [ "string", "null" ] }, "used_cents": { "type": "integer" }, "window": { "enum": [ "1h", "1d", "7d", "daily", "weekly", "monthly", "lifetime" ], "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } ] }, "id": { "type": "string" }, "status": { "enum": [ "failed" ], "type": "string" } }, "required": [ "id", "status", "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": { "code": "generation_failed", "message": "Task processing failed." }, "id": "tsk_reference_demo", "status": "failed" } ``` ## 錯誤 HTTP 401 - POST /api/v1/elevenlabs/speech_to_text ### 回應結構 ```json { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "Authentication required" } ``` ## 錯誤 HTTP 401 - GET /api/v1/elevenlabs/speech_to_text/:id ### 回應結構 ```json { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "Authentication required" } ``` ## 錯誤 HTTP 400 - POST /api/v1/elevenlabs/speech_to_text ### 回應結構 ```json { "oneOf": [ { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false }, { "properties": { "error": { "description": "人類可讀的驗證摘要。", "type": "string" }, "errors": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "description": "以公開請求欄位為鍵的驗證訊息，每個欄位對應一組人類可讀的字串陣列。", "type": "object" } }, "required": [ "error", "errors" ], "type": "object", "unevaluatedProperties": false } ] } ``` ### 回應範例 ```json { "error": "Validation failed", "errors": { "source_audio_url": [ "is required" ] } } ``` ## 錯誤 HTTP 402 - POST /api/v1/elevenlabs/speech_to_text ### 回應結構 ```json { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "Insufficient balance" } ``` ## 錯誤 HTTP 429 - POST /api/v1/elevenlabs/speech_to_text ### 回應結構 ```json { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "API key credit limit exceeded" } ``` ## 錯誤 HTTP 409 - POST /api/v1/elevenlabs/speech_to_text ### 回應結構 ```json { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "The request uses features that are not supported for the selected model" } ``` ## 錯誤 HTTP 429 - POST /api/v1/elevenlabs/speech_to_text ### 回應結構 ```json { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "Rate limit reached. Please retry later." } ``` ## 錯誤 HTTP 503 - POST /api/v1/elevenlabs/speech_to_text ### 回應結構 ```json { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "Service under maintenance, please try again later" } ``` ## 錯誤 HTTP 504 - POST /api/v1/elevenlabs/speech_to_text ### 回應結構 ```json { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "The request timed out" } ``` ## 錯誤 HTTP 404 - GET /api/v1/elevenlabs/speech_to_text/:id ### 回應結構 ```json { "properties": { "error": { "description": "人類可讀的錯誤訊息。", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 回應範例 ```json { "error": "Task with id 'tsk_reference_demo' not found" } ``` ## 已生成的程式碼範例 直接使用 cURL，或為您的語言安裝 SDK。每個範例均提交本參考中所示的已驗證請求。 ### curl ```curl curl -X POST https://runapi.ai/api/v1/elevenlabs/speech_to_text \ -H 'Authorization: Bearer YOUR_API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"source_audio_url":"https://file.runapi.ai/source-audio.mp3","language_code":"en","diarize":true}' ``` ### javascript #### 安裝 ```bash npm install @runapi.ai/elevenlabs ``` ```javascript import { ElevenlabsClient } from "@runapi.ai/elevenlabs"; const client = new ElevenlabsClient({ apiKey: process.env.RUNAPI_API_KEY }); const task = await client.speechToText.create({ "source_audio_url": "https://file.runapi.ai/source-audio.mp3", "language_code": "en", "diarize": true }); ``` ### python #### 安裝 ```bash pip install runapi-elevenlabs ``` ```python import os from runapi.elevenlabs import ElevenlabsClient client = ElevenlabsClient(api_key=os.environ["RUNAPI_API_KEY"]) task = client.speech_to_text.create( source_audio_url="https://file.runapi.ai/source-audio.mp3", language_code="en", diarize=True ) ``` ### go #### 安裝 ```bash go get github.com/runapi-ai/elevenlabs-sdk/go@latest ``` ```go package main import ( "context" "log" "os" "github.com/runapi-ai/core-sdk/go/option" elevenlabs "github.com/runapi-ai/elevenlabs-sdk/go/elevenlabs" ) func main() { client, err := elevenlabs.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY"))) if err != nil { log.Fatal(err) } task, err := client.SpeechToText.Create(context.Background(), elevenlabs.SpeechToTextParams{ SourceAudioURL: "https://file.runapi.ai/source-audio.mp3", LanguageCode: "en", Diarize: func(value bool) *bool { return &value }(true), }) if err != nil { log.Fatal(err) } _ = task } ``` ### ruby #### 安裝 ```bash gem install runapi-elevenlabs ``` ```ruby require "runapi/elevenlabs" client = RunApi::Elevenlabs::Client.new(api_key: ENV.fetch("RUNAPI_API_KEY")) task = client.speech_to_text.create( source_audio_url: "https://file.runapi.ai/source-audio.mp3", language_code: "en", diarize: true ) ``` ### java #### 安裝 ```kotlin implementation("ai.runapi:runapi-elevenlabs") ``` ```java import ai.runapi.elevenlabs.ElevenLabsClient; import ai.runapi.elevenlabs.types.SpeechToTextParams; import ai.runapi.core.polling.TaskCreateResponse; public final class Example { public static void main(String[] args) { ElevenLabsClient client = ElevenLabsClient.builder() .apiKey(System.getenv("RUNAPI_API_KEY")) .build(); TaskCreateResponse task = client.speechToText().create( SpeechToTextParams.builder() .sourceAudioUrl("https://file.runapi.ai/source-audio.mp3") .languageCode("en") .diarize(true) .build() ); } } ``` ### php #### 安裝 ```bash composer require runapi-ai/elevenlabs ``` ```php speechToText->create([ "source_audio_url" => "https://file.runapi.ai/source-audio.mp3", "language_code" => "en", "diarize" => true ]); ``` ## 相關指南 - [身份驗證](https://runapi.ai/zh-HK/docs/guides/authentication.md) - [快速入門](https://runapi.ai/zh-HK/docs/guides/task-api/quickstart.md) --- ## RunAPI 的更多內容 - [首頁](https://runapi.ai/zh-HK/.md) - [模型目錄](https://runapi.ai/zh-HK/models.md) - [收費](https://runapi.ai/zh-HK/pricing.md) - [服務商](https://runapi.ai/zh-HK/models) - [文件](https://runapi.ai/zh-HK/docs/guides) - [SDK](https://runapi.ai/zh-HK/sdk.md) - [CLI](https://runapi.ai/zh-HK/cli.md) - [MCP Server](https://runapi.ai/zh-HK/mcp.md) - [Claude Code 與 Cursor](https://runapi.ai/zh-HK/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-HK/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-HK/openrouter-alternative.md) - [企業版](https://runapi.ai/zh-HK/contact.md) - [聯絡](https://runapi.ai/zh-HK/contact.md) - [條款](https://runapi.ai/zh-HK/terms.md) - [私隱](https://runapi.ai/zh-HK/privacy.md) - [智能代理網站索引](https://runapi.ai/llms.txt) 聯絡我們: contact@runapi.ai ## 結構化資料 ```json [ { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-HK/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-HKicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "TechArticle", "headline": "ElevenLabs 語音轉文字", "description": "使用語音轉文字端點以建立非同步任務。", "url": "https://runapi.ai/zh-HK/docs/api/elevenlabs/speech-to-text", "mainEntityOfPage": "https://runapi.ai/zh-HK/docs/api/elevenlabs/speech-to-text" } ] ```