Runway サウンドエフェクトを生成

POST

runwayml

sound_effect

curl https://api.cometapi.com/runwayml/v1/sound_effect \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "eleven_text_to_sound_v2",
  "promptText": "Gentle rain falling on a wooden roof with distant thunder.",
  "duration": 5.5,
  "loop": true
}'

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

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

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

POST /runwayml/v1/sound_effect を使用して、テキストプロンプトからオーディオタスクを作成します。 CometAPI API キーを Bearer 認証と JSON リクエスト本文で送信します。

モデルを選択

モデル ID	必須入力	オプションのコントロール
`eleven_text_to_sound_v2`	`promptText` 1～3000 文字	`duration` 0.5～30 秒（小数秒を含む）； `loop`
`seed_audio`	`promptText` 1～2048 文字	最大 3 つの `referenceAudios`、音声、音量、ピッチのコントロール、出力形式

eleven_text_to_sound_v2 では、duration を省略して、長さをプロンプトに基づいて選択します。繰り返しサウンドエフェクトをリクエストするには、loop: true を設定します。 seed_audio では、プロンプト内で referenceAudios を @Audio1、@Audio2、および @Audio3 として配列順に参照します。参照が不要な場合は referenceAudios を省略します。各サンプルオーディオ URL を、アクセス可能な音声ファイルの HTTPS URL に置き換えます。このエンドポイントでは、このモデルとともに duration、loop、または voice を含めないでください。

オーディオコントロールを設定

フィールド	値	意味
`speechRate`	-50～100 の整数	負の値では音声が遅くなり、正の値では速くなります。
`loudnessRate`	-50～100 の整数	負の値では音量が下がり、正の値では上がります。
`pitchRate`	-12～12 の整数	半音単位のピッチシフト。
`sampleRate`	`8000`, `16000`, `24000`, `32000`, `44100`, `48000`	Hz 単位のオーディオサンプルレート。
`outputFormat`	`wav`, `mp3`, `ogg_opus`	出力オーディオ形式。

3 つのレートコントロールでは、フィールドを省略するか、0 を使用して通常値を維持します。

結果を取得

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

承認

Authorization

string

header

必須

Use your CometAPI API key.

ボディ

application/json

eleven_text_to_sound_v2
seed_audio

Request settings for eleven_text_to_sound_v2.

model

enum<string>

必須

Model ID for this request.

利用可能なオプション:

eleven_text_to_sound_v2

Allowed value: "eleven_text_to_sound_v2"

promptText

string

必須

A text description of the sound effect to generate.

Required string length: 1 - 3000

duration

number

Sound effect duration in seconds, from 0.5 to 30. Fractional seconds are accepted. Omit this field to choose duration from the prompt.

必須範囲: 0.5 <= x <= 30

loop

boolean

デフォルト:false

Set true to request a sound effect that loops seamlessly. Defaults to false.

レスポンス

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/sound_effect \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "eleven_text_to_sound_v2",
  "promptText": "Gentle rain falling on a wooden roof with distant thunder.",
  "duration": 5.5,
  "loop": true
}'

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

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

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

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

APIキー

Runway サウンドエフェクトを生成

モデルを選択

オーディオコントロールを設定

結果を取得

承認

ボディ

レスポンス

​モデルを選択

​オーディオコントロールを設定

​結果を取得

承認

ボディ

レスポンス

モデルを選択

オーディオコントロールを設定

結果を取得