Metinden Runway konuşması oluşturun

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

Metinden bir konuşma görevi oluşturmak için POST /runwayml/v1/text_to_speech kullanın. CometAPI API anahtarınızı Bearer kimlik doğrulaması ve bir JSON istek gövdesiyle gönderin.

Model ve ses seçme

Her istek için model ve promptText gereklidir. voice alanı zorunludur eleven_multilingual_v2 ve eleven_v3 için, seed_audio için ise isteğe bağlıdır.

Model ID	Metin sınırı	Ses yapılandırması
`eleven_multilingual_v2`	1000 UTF-16 kod birimi	`type: runway-preset` ve örneğin bir `presetId`, `Maya`
`eleven_v3`	5000 karakter	`type: runway-preset` ve örneğin bir `presetId`, `Maya`
`seed_audio`	2048 karakter	Varsayılan bir ses için `voice` öğesini atlayın veya `type: reference-audio` ve bir `audioUri`

Önceden ayarlanmış sesler için istek şemasından bir presetId seçin. seed_audio için örnek audioUri değerini ses referansınızın erişilebilir HTTPS URL’siyle değiştirin.

Konuşma ifadesini ayarlama

eleven_v3 ile promptText, [whispers] gibi ifade etiketleri içerebilir veya [laughs]. Model ayrıca şu denetimleri kabul eder:

Alan	Değerler	Anlamı
`stability`	0 ile 1 arasında sayı	Sıfır olmayan düşük değerler daha fazla ifadeye izin verir; yüksek değerler daha sabittir.
`similarityBoost`	0 ile 1 arasında sayı	Yüksek değerler seçilen sesi daha yakından takip eder.
`style`	0 ile 1 arasında sayı	Yüksek değerler ses stilini vurgular.
`speed`	0,7 ile 1,2 arasında sayı	`1` normal hızı kullanır.
`useSpeakerBoost`	`true`	Seçilen sesle daha fazla benzerlik isteyin.
`languageCode`	ISO 639-1 dil kodu	Telaffuzu ve metin normalleştirmeyi yönlendirin.
`applyTextNormalization`	`auto`, `on`, `off`	Sayılar gibi metinlerin konuşulan sözcüklere nasıl dönüştüğünü denetleyin.
`seed`	1 ile 4294967295 arasında tamsayı	Örnekleme seed değerini ayarlayın.

stability, similarityBoost ve style için 0 değeri modeli varsayılanını kullanır; alanın atlanması da aynı sonucu verir. useSpeakerBoost: false da modeli varsayılanını kullanır. Bir örnekleme seed değeri ayarlamak için pozitif bir tamsayı kullanın; seed: 0 bir seed değeri otomatik olarak seçer.

Konuşma hızını ve biçimini ayarlama

seed_audio ile speechRate ve loudnessRate için -50 ile 100 arasındaki değerleri veya pitchRate -12 ile 12 yarım ses arasındaki değerleri kullanın. Bu denetimler tamsayı kabul eder; alanın atlanması veya 0 normal değeri korur. sampleRate değerini 8000, 16000, 24000, 32000, 44100 veya 48000 Hz olarak ayarlayın. outputFormat değerini wav, mp3 veya ogg_opus olarak ayarlayın. Bu uç noktada duration öğesini eklemeyin, referenceAudios, veya seed_audio ile Eleven v3 denetimlerini eklemeyin.

Sonucu alma

Döndürülen id değerini kaydedin, ardından Bir Runway görevi alma görev durumunu almak için kullanın. status değeri SUCCEEDED olduğunda, ses URL’lerini outputiçinde okuyun. 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_multilingual_v2
eleven_v3
seed_audio

Request settings for eleven_multilingual_v2.

model

enum<string>

gerekli

Model ID for this request.

Mevcut seçenekler:

eleven_multilingual_v2

Allowed value: "eleven_multilingual_v2"

promptText

string

gerekli

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

Required string length: 1 - 1000

voice

RunwayPresetVoice · object

gerekli

The voice to use for the generated speech.

Show child attributes

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

İçerik moderasyonu

API anahtarları

Metinden Runway konuşması oluşturun

Model ve ses seçme

Konuşma ifadesini ayarlama

Konuşma hızını ve biçimini ayarlama

Sonucu alma

Yetkilendirmeler

Gövde

Yanıt

​Model ve ses seçme

​Konuşma ifadesini ayarlama

​Konuşma hızını ve biçimini ayarlama

​Sonucu alma

Yetkilendirmeler

Gövde

Yanıt

Model ve ses seçme

Konuşma ifadesini ayarlama

Konuşma hızını ve biçimini ayarlama

Sonucu alma