Generer Runway-tale fra tekst

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

Bruk POST /runwayml/v1/text_to_speech til å opprette en taleoppgave fra tekst. Send CometAPI API-nøkkelen med Bearer-autentisering og en JSON-forespørselskropp.

Velg en modell og stemme

Hver forespørsel krever model og promptText. Feltet voice er påkrevd for eleven_multilingual_v2 og eleven_v3, og valgfritt for seed_audio.

Modell-ID	Tekstgrense	Stemmekonfigurasjon
`eleven_multilingual_v2`	1000 UTF-16-kodeenheter	`type: runway-preset` og en `presetId`, for eksempel `Maya`
`eleven_v3`	5000 tegn	`type: runway-preset` og en `presetId`, for eksempel `Maya`
`seed_audio`	2048 tegn	Utelat `voice` for en standardstemme, eller bruk `type: reference-audio` og en `audioUri`

For forhåndsinnstilte stemmer velger du en presetId fra forespørselsskjemaet. For seed_audio, erstatter du eksempelet audioUri med en tilgjengelig HTTPS-URL til stemmereferansen din.

Juster taleuttrykket

Med eleven_v3 kan promptText inneholde uttrykksfulle tagger som [whispers] eller [laughs]. Modellen godtar også disse kontrollene:

Felt	Verdier	Betydning
`stability`	Tall fra 0 til 1	Lavere verdier som ikke er null, tillater mer uttrykk; høyere verdier er jevnere.
`similarityBoost`	Tall fra 0 til 1	Høyere verdier følger den valgte stemmen tettere.
`style`	Tall fra 0 til 1	Høyere verdier fremhever stemmestilen.
`speed`	Tall fra 0,7 til 1,2	`1` bruker normal hastighet.
`useSpeakerBoost`	`true`	Be om større likhet med den valgte stemmen.
`languageCode`	ISO 639-1-språkkode	Veiled uttale og tekstnormalisering.
`applyTextNormalization`	`auto`, `on`, `off`	Kontroller hvordan tekst, for eksempel tall, blir til talte ord.
`seed`	Heltall fra 1 til 4294967295	Angi samplingfrøet.

For stability, similarityBoost og style bruker en verdi på 0 modellens standardverdi, det samme gjelder hvis feltet utelates. useSpeakerBoost: false bruker også modellens standardverdi. Hvis du vil angi et samplingfrø, bruker du et positivt heltall; seed: 0 velger et frø automatisk.

Juster talehastighet og format

Med seed_audio bruker du speechRate og loudnessRate fra -50 til 100, eller pitchRate fra -12 til 12 halvtoner. Disse kontrollene godtar heltall; utelatelse eller 0 beholder normalverdien. Sett sampleRate til 8000, 16000, 24000, 32000, 44100 eller 48000 Hz. Sett outputFormat til wav, mp3 eller ogg_opus. Ikke inkluder duration, referenceAudios, eller Eleven v3-kontroller med seed_audio på dette endepunktet.

Hent resultatet

Lagre den returnerte id, og bruk Hent en Runway-oppgave for å hente oppgavestatus. Når status er SUCCEEDED, leser du lyd-URL-ene i output. Hvis oppgaven mislykkes, undersøker du failure og failureCode.

Autorisasjoner

Authorization

string

header

påkrevd

Use your CometAPI API key.

Kropp

application/json

eleven_multilingual_v2
eleven_v3
seed_audio

Request settings for eleven_multilingual_v2.

model

enum<string>

påkrevd

Model ID for this request.

Tilgjengelige alternativer:

eleven_multilingual_v2

Allowed value: "eleven_multilingual_v2"

promptText

string

påkrevd

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

Required string length: 1 - 1000

voice

RunwayPresetVoice · object

påkrevd

The voice to use for the generated speech.

Show child attributes

Svar

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

string

påkrevd

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

Sist endret 18. september 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>"
  }
}

Innholdsmoderering

API-nøkler

Velg en modell og stemme

Juster taleuttrykket

Juster talehastighet og format

Hent resultatet

Autorisasjoner

Kropp

Svar

​Velg en modell og stemme

​Juster taleuttrykket

​Juster talehastighet og format

​Hent resultatet

Autorisasjoner

Kropp

Svar

Velg en modell og stemme

Juster taleuttrykket

Juster talehastighet og format

Hent resultatet