テキストから Runway 音声を生成する

POST

runwayml

text_to_speech

curl https://api.cometapi.com/runwayml/v1/text_to_speech \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "eleven_multilingual_v2",
  "promptText": "Welcome to our audio guide. Let us begin the tour.",
  "voice": {
    "type": "runway-preset",
    "presetId": "Maya"
  }
}'

{
  "id": "123e4567-e89b-42d3-a456-426614174000"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

POST /runwayml/v1/text_to_speech を使用して、テキストから音声タスクを作成します。 Bearer 認証と JSON リクエスト本文で CometAPI API キーを送信します。

モデルと音声を選択する

すべてのリクエストには model と promptText が必要です。voice フィールドは eleven_multilingual_v2 および eleven_v3 では必須で、seed_audio では任意です。

モデル ID	テキスト上限	音声設定
`eleven_multilingual_v2`	1000 UTF-16 コードユニット	`type: runway-preset` および、たとえば `presetId` `Maya`
`eleven_v3`	5000 文字	`type: runway-preset` および、たとえば `presetId` `Maya`
`seed_audio`	2048 文字	デフォルト音声を使用するには `voice` を省略するか、`type: reference-audio` と `audioUri`

プリセット音声では、リクエストスキーマから presetId を選択します。seed_audio では、例の audioUri を、音声参照にアクセス可能な HTTPS URL に置き換えます。

音声表現を調整する

eleven_v3 では、promptText に [whispers] や [laughs] などの表現タグを含めることができます。モデルでは、次のコントロールも使用できます。

フィールド	値	意味
`stability`	0～1 の数値	ゼロ以外の低い値では表現が豊かになり、高い値ではより安定します。
`similarityBoost`	0～1 の数値	値が高いほど、選択した音声により忠実に従います。
`style`	0～1 の数値	値が高いほど、音声スタイルが強調されます。
`speed`	0.7～1.2 の数値	`1` は通常速度を使用します。
`useSpeakerBoost`	`true`	選択した音声との類似性を高めるよう要求します。
`languageCode`	ISO 639-1 言語コード	発音とテキスト正規化をガイドします。
`applyTextNormalization`	`auto`, `on`, `off`	数値などのテキストを読み上げ語に変換する方法を制御します。
`seed`	1～4294967295 の整数	サンプリングシードを設定します。

stability、similarityBoost、および style では、0 の値を指定するとモデルのデフォルトが使用され、フィールドを省略した場合も同様です。useSpeakerBoost: false でもモデルのデフォルトが使用されます。サンプリングシードを設定するには正の整数を使用します。seed: 0 ではシードが自動的に選択されます。

音声速度と形式を調整する

seed_audio では、speechRate と loudnessRate に -50～100 の値を使用するか、 pitchRate -12～12 半音の値を使用します。これらのコントロールには整数を指定でき、省略するか 0 を指定すると通常の値が維持されます。 sampleRate を 8000、16000、24000、32000、44100、または 48000 Hz に設定します。 outputFormat を wav、mp3、または ogg_opus に設定します。このエンドポイントでは、duration、 referenceAudiosまたは seed_audio を使用する Eleven v3 コントロールを含めないでください。

結果を取得する

返された id を保存してから、 Runway タスクを取得するを使用してタスクのステータスを取得します。status が SUCCEEDED の場合、音声 URL を次から読み取ります： output。タスクが失敗した場合は、failure と failureCode を確認します。

承認

Authorization

string

header

必須

Use your CometAPI API key.

ボディ

application/json

eleven_multilingual_v2
eleven_v3
seed_audio

Request settings for eleven_multilingual_v2.

model

enum<string>

必須

Model ID for this request.

利用可能なオプション:

eleven_multilingual_v2

Allowed value: "eleven_multilingual_v2"

promptText

string

必須

Text to speak, from 1 to 1000 UTF-16 code units.

Required string length: 1 - 1000

voice

RunwayPresetVoice · object

必須

The voice to use for the generated speech.

Show child attributes

レスポンス

Task created. Save the returned id to retrieve task status.

string

必須

Task ID for GET /runwayml/v1/tasks/{id}.

status

string

Task state, when returned.

createdAt

string<date-time>

Task submission timestamp, when returned.

output

string<uri>[]

Result URLs, when returned.

failure

string

Failure explanation, when returned.

failureCode

string

Machine-readable failure code, when returned.

estimatedCost

object

Task estimate metadata, when returned.

Show child attributes

cost

object

Task cost metadata, when returned.

Show child attributes

最終更新日 2026年9月18日

curl https://api.cometapi.com/runwayml/v1/text_to_speech \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "eleven_multilingual_v2",
  "promptText": "Welcome to our audio guide. Let us begin the tour.",
  "voice": {
    "type": "runway-preset",
    "presetId": "Maya"
  }
}'

{
  "id": "123e4567-e89b-42d3-a456-426614174000"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

コンテンツモデレーション

APIキー

テキストから Runway 音声を生成する

モデルと音声を選択する

音声表現を調整する

音声速度と形式を調整する

結果を取得する

承認

ボディ

レスポンス

​モデルと音声を選択する

​音声表現を調整する

​音声速度と形式を調整する

​結果を取得する

承認

ボディ

レスポンス

モデルと音声を選択する

音声表現を調整する

音声速度と形式を調整する

結果を取得する