Runway ses efektleri oluşturun

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>"
  }
}

Bir metin Prompt’undan ses görevi oluşturmak için POST /runwayml/v1/sound_effect kullanın. CometAPI API anahtarınızı Bearer kimlik doğrulaması ve bir JSON istek gövdesiyle gönderin.

Bir model seçin

Model kimliği	Gerekli girdiler	İsteğe bağlı denetimler
`eleven_text_to_sound_v2`	`promptText` 1–3000 karakterle	`duration` kesirli saniyeler dahil 0.5 ile 30 saniye arasında; `loop`
`seed_audio`	`promptText` 1–2048 karakterle	En fazla üç `referenceAudios`; konuşma, ses yüksekliği ve perde denetimleri; çıktı biçimi

eleven_text_to_sound_v2 için, uzunluğu şuradaki Prompt’tan seçmek üzere duration alanını atlayın Prompt. Tekrarlayan bir ses efekti istemek için loop: true ayarlayın. seed_audio için, Prompt’ta referenceAudios öğesine @Audio1, @Audio2, ve @Audio3 olarak, dizi sırasıyla atıfta bulunun. Referansa ihtiyacınız olmadığında referenceAudios alanını atlayın. Her örnek ses URL’sini ses dosyanızın erişilebilir bir HTTPS URL’siyle değiştirin. Bu uç noktada bu modelle birlikte duration, loop veya voice eklemeyin.

Ses denetimlerini yapılandırın

Alan	Değerler	Anlamı
`speechRate`	-50 ile 100 arasında tamsayı	Negatif değer konuşmayı yavaşlatır; pozitif değer hızlandırır.
`loudnessRate`	-50 ile 100 arasında tamsayı	Negatif değer ses düzeyini azaltır; pozitif değer artırır.
`pitchRate`	-12 ile 12 arasında tamsayı	Yarı ton cinsinden perde kaydırma.
`sampleRate`	`8000`, `16000`, `24000`, `32000`, `44100`, `48000`	Hz cinsinden ses örnekleme hızı.
`outputFormat`	`wav`, `mp3`, `ogg_opus`	Çıktı ses biçimi.

Üç oran denetimi için, normal değerini korumak üzere alanı atlayın veya 0 kullanın.

Sonucu alın

Döndürülen id değerini kaydedin, ardından Bir Runway görevi alın görev durumunu almak için kullanın. status değeri SUCCEEDED olduğunda, şuradaki ses URL’lerini okuyun output. Görev başarısız olursa failure ve failureCode öğelerini inceleyin.

Yetkilendirmeler

Authorization

string

header

gerekli

Use your CometAPI API key.

Gövde

application/json

eleven_text_to_sound_v2
seed_audio

Request settings for eleven_text_to_sound_v2.

model

enum<string>

gerekli

Model ID for this request.

Mevcut seçenekler:

eleven_text_to_sound_v2

Allowed value: "eleven_text_to_sound_v2"

promptText

string

gerekli

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.

Gerekli aralık: 0.5 <= x <= 30

loop

boolean

varsayılan:false

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

Yanıt

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

string

gerekli

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

Son değiştirilme tarihi 18 Eylül 2026

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>"
  }
}

İçerik moderasyonu

API anahtarları

Bir model seçin

Ses denetimlerini yapılandırın

Sonucu alın

Yetkilendirmeler

Gövde

Yanıt

​Bir model seçin

​Ses denetimlerini yapılandırın

​Sonucu alın

Yetkilendirmeler

Gövde

Yanıt

Bir model seçin

Ses denetimlerini yapılandırın

Sonucu alın