Dokumentasjon for tekst-til-tale APIet: Kom i gang og integrer

Av TekstTale API-redaksjonen · Oppdatert 2026-11-19

Denne dokumentasjonen gir deg alt du trenger for å integrere RøstKode sin tekst-til-tale-API i applikasjonene dine. Du finner detaljert informasjon om API-grensesnittet, inkludert hvordan du sender tekst og mottar lydfiler. Vi dekker alle viktige parametere som stemmevalg, hastighet og lydformater, slik at du kan skreddersy lydutfallene nøyaktig etter dine behov.

Håndboken er skreddersydd for indieutviklere og produktteam som ønsker en enkel REST-løsning uten store overhead-kostnader. Du lærer hvordan du henter din API-nøkkel, konfigurerer OpenAI SDK-en med riktig base_url, og håndterer feil og rate limits effektivt. Med konkrete kodeeksempler i Python og Node.js kommer du raskt i gang med å levere høykvalitets lyd direkte fra din backend.

Dokumentasjon for tekst-til-tale APIet: Kom i gang og integrer

Ofte stilte spørsmål

Hvordan henter jeg en API-nøkkel?

Gå til /get-api-key/ og logg inn med Google eller e-post. Du får en aktiv nøkkel umiddelbart. Du kan utstede en ny nøkkel når som helst, og den gamle stopper øyeblikkelig. Nøkkelen starter med prefikset "tts-" og brukes i Authorization-headeren.

Hvordan kan jeg bruke OpenAI SDK med dette APIet?

Endre base_url til https://api.bet994.info/v1 og bruk din RøstKode-nøkkel. Forespørselsstrukturen er identisk med OpenAI sine speech-endepunkter. Dette gjør det enkelt å bytte ut API-et uten å endre mye kode i eksisterende integrasjoner.

Hvilke parametere kan jeg sende i forespørselen?

Du trenger model, input (tekst opp til 4096 tegn), voice, response_format, speed og valgfritt language. Modellene er "tts-1" eller "tts-1-hd", stemmene er blant de åtte preset-ene, og formatene inkluderer mp3, wav, opus, flac og pcm.

Hva er forskjellen mellom tts-1 og tts-1-hd?

Begge modellene bruker samme motor og har samme pris per tegn. De bruker samme motor og pris. Velg basert på om du prioriterer kvalitet eller filstørrelse, men kostnaden er identisk for begge alternativer.

Hvordan kan jeg angi hastighet på stemmen?

Bruk speed-parameteren i JSON-bodyet. Verdien må være mellom 0.25 og 4.0. Standardhastigheten er vanligvis 1.0. Dette lar deg akselerere eller senke talehastigheten for å tilpasse innholdet til ulike kontekster, som for eksempel undervisning eller nyhetsopplesning.

Hva skjer hvis jeg overskrider rate limits?

Du har 60 forespørsler per minutt per nøkkel (10 før første påfylling). Hvis du overskrider dette, kan forespørsler køes eller feile. Under last kan prosessering ta lenger tid. Det er lurt å implementere eksponentiell backoff for å håndtere feil grasiøst.

Hvordan kan jeg feilsøke en mislykket forespørsel?

Sjekk HTTP-statuskoden og feilmeldingen i responsen. Hvis syntesen feiler, returneres beløpet i full størrelse. Sørg for at teksten er under 4096 tegn og at nøkkelen er gyldig. Feil kan skyldes ugyldige parametere eller midlertidige lastproblemer på serveren.

Er det mulig å få en feilrespons med detaljer?

Ja, API-et returnerer en JSON-feilrespons med en beskrivende melding. Dette hjelper deg med å identifisere om problemet er en ugyldig parameter, utløpt nøkkel eller en midlertidig feil. Les feilmeldingen nøye for å rette opp koden din raskt.

Hvordan kan jeg se min brukshistorikk?

Logg inn på /get-api-key/ for å se balanse, karakterer brukt og historikk. Du kan også hente detaljer via GET /v1/usage hvis dette endepunktet er tilgjengelig, ellers vises statistikk direkte i dashboardet. Metadata lagres for fakturering.

Er det mulig å få en rabatt ved stor volumbruk?

Nei, prisen er fast på $10 per million tegn uavhengig av volum. Det er ingen månedlige abonnement eller volumrabatter. Du betaler kun for det du bruker, og mislykkede forespørsler er gratis. Det er ingen minimumsforbruk eller binding.

Første forespørsel

curl

curl https://api.bet994.info/v1/audio/speech \
  -H "Authorization: Bearer $TTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"tts-1","voice":"aria","input":"Hello from the API.","response_format":"mp3"}' \
  --output hello.mp3

Python (openai)

from openai import OpenAI

client = OpenAI(base_url="https://api.bet994.info/v1", api_key="tts-...")

with client.audio.speech.with_streaming_response.create(
    model="tts-1", voice="nova", input="Hello from Python.", response_format="mp3"
) as response:
    response.stream_to_file("hello.mp3")

Node.js (openai)

import OpenAI from "openai";
import fs from "node:fs";

const client = new OpenAI({ baseURL: "https://api.bet994.info/v1", apiKey: process.env.TTS_API_KEY });
const res = await client.audio.speech.create({ model: "tts-1", voice: "milo", input: "Hello from Node.js." });
fs.writeFileSync("hello.mp3", Buffer.from(await res.arrayBuffer()));
voice
ariakvinne
novakvinne
lunakvinne
sagekvinne
felixmann
milomann
atlasmann
orionmann
language
arالعربية
zh中文
daDansk
nlNederlands
enEnglish
fiSuomi
frFrançais
deDeutsch
elΕλληνικά
heעברית
hiहिन्दी
itItaliano
ja日本語
ko한국어
msBahasa Melayu
noNorsk
plPolski
ptPortuguês
ruРусский
esEspañol
swKiswahili
svSvenska
trTürkçe

Hent API-nøkkel

Illustrasjon av lydbølge for: Hent API-nøkkel

Før du kan begynne å sende tekst til tale, må du opprette en konto på /get-api-key/. Her finner du oversikten over din API-nøkkel, gjeldende balanse og et ferdig cURL-eksempel du kan teste med en gang.

Registreringen tar bare noen sekunder, og du får umiddelbar tilgang til grensesnittet som styrer hele integrasjonen din.

Registrer deg på /get-api-key/

Registrer deg på /get-api-key/

Gå til /get-api-key/ for å lage din konto. Siden viser nøkkelen din, karakteristisk balanse og en oversikt over hvor mange tegn du har igjen å bruke. Herfra styrer du hele tilgangen til TTS API-et.

Bruk Google eller e-post

Bruk Google eller e-post

Du kan logge inn med Google-kontoen din eller opprette en konto med e-post og passord. Merk at Google-innlogging gir deg en gratis prøveperiode på $0,50 i kreditt (ca. 50 000 tegn) i 7 dager. E-post-kontoer starter uten denne kreditten.

  • Google: Automatisk prøveperiode på $0,50 i 7 dager
  • E-post: Ingen prøveperiode, full kontroll fra start

Få nøkkelen din umiddelbart

Når kontoen er opprettet, får du en aktiv API-nøkkel formatert som tts-.... Denne nøkkelen bruker du i Authorization: Bearer-hodet for å autentisere forespørslene dine. Du kan generere en ny nøkkel når som helst, og den gamle stopper umiddelbart.

Første forespørsel

Illustrasjon av lydbølge for: Første forespørsel

Med nøkkelen klar kan du teste APIet direkte. Send en POST-forespørsel til https://api.bet994.info/v1/audio/speech med teksten din. Du mottar en lydfil i det formatet du valgte, klar til å integreres i appen din.

For en smidigere integrasjon, endre base_url i OpenAI SDK-en din til https://api.bet994.info/v1. Siden forespørselsstrukturen er den samme, fungerer dine eksisterende OpenAI SDK-pakker uten ekstra konfigurasjon.

Bruk cURL for å sende tekst

Kjør følgende kommando i terminalen din. Bytt ut din-nøkkel med API-nøkkelen fra /get-api-key/. Teksten må være under 4096 tegn.

curl -X POST "https://api.bet994.info/v1/audio/speech" \ -H "Authorization: Bearer din-nøkkel" \ -H "Content-Type: application/json" \ -d '{"model": "tts-1", "input": "Hei, dette er en test", "voice": "nova", "response_format": "mp3"}' \ -o output.mp3

  • Bruk tts-1 eller tts-1-hd som modell.
  • Velg en av 8 stemmer via voice-feltet.

Angi base_url for OpenAI SDK

Endre base_url til https://api.bet994.info/v1. Dette sikrer at SDK-en sender data til RøstKode.

Dette fungerer med alle offisielle OpenAI SDK-er. Du beholder samme request-shape og autentisering med Bearer-token.

  • Støtter Python, Node.js og flere språk.
  • Ingen ekstra bibliotek nødvendig.

Motta lyd i valgt format

API-et returnerer en lydfil direkte i responsen. Du kan velge mellom MP3, WAV, OPUS, FLAC eller PCM.

Lydfilen lagres ikke på våre servere, men returneres umiddelbart til din klient.

Hvis syntesen feiler, returneres feilen uten kostnad.

  • MP3 for komprimert lagring.
  • WAV for høy kvalitet.
  • OPUS for lav båndbredde.
  • FLAC for tapløs komprimering.
  • PCM for rå lyd.

OpenAI SDK integrasjon

Illustrasjon av lydbølge for: OpenAI SDK integrasjon

Du kan bruke de offisielle OpenAI-SDKene direkte til RøstKode API ved å bare endre base_url til https://api.bet994.info/v1. Dette gjør det enkelt å bytte fra eksisterende løsninger uten å endre selve koden som håndterer forespørsler og respons.

Siden forespørselsstrukturen er identisk med OpenAI sine, fungerer alle OpenAI SDKs uten justeringer. Du beholder din kjente arbeidsflyt, men sender lydgenereringen til vår API-grensesnitt i stedet.

Endre base_url til api.bet994.info

Oppdater konfigurasjonen i SDK-en din til å peke mot https://api.bet994.info/v1. Dette er eneste endring du trenger for å rettle SDK-en til å kommunisere med RøstKode.

Du beholder din eksisterende API-nøkkel fra /get-api-key/ og bruker den som vanlig i Authorization-hodet.

Bruk samme request-shape

Forespørsler følger samme struktur som OpenAI sine TTS-endepunkt. Du sender en JSON-body med felt som model, input, voice og response_format.

Alle parametere som speed og language fungerer som forventet. SDK-en håndterer serialisering av disse feltene automatisk.

Støtter alle OpenAI SDKs

Både Python, Node.js og andre offisielle SDK-er fungerer ut av boksen. Du trenger ikke en egen RøstKode-SDK eller tilpassede biblioteker.

Dette gir deg fleksibilitet til å bruke det språket og biblioteket du allerede er komfortabel med i ditt prosjekt.

Forespørselsparametere

Illustrasjon av lydbølge for: Forespørselsparametere

API-et krever tre hovedparametere for å generere tale: model, input og voice. Disse定er grunnleggende for hvordan lyden blir tilrettelagt og levert.

model: tts-1 eller tts-1-hd

Du velger mellom tts-1 og tts-1-hd. Begge bruker samme motor og har identisk pris, så valget påvirker kun kvaliteten på lyden.

input: tekst opptil 4096 tegn

Selve teksten sendes i feltet input. Maksimum lengde er 4096 tegn per forespørsel, inkludert mellomrom og tegnsett. For lengre tekster må du dele opp teksten manuelt og koble filene.

voice: velg en av 8 stemmer

Feltet voice krever en av de 8 tilgjengelige preset-stemmene. Disse varierer fra varm fortellerstemme til dyp dokumentar-tale, og hver stemme kan tale alle 23 støttede språk.

Du må spesifisere språkkoden hvis teksten er på et annet språk enn engelsk for å sikre korrekt uttale.

  • Female: aria, nova, luna, sage
  • Male: felix, milo, atlas, orion

Format og hastighet

Illustrasjon av lydbølge for: Format og hastighet

Du velger utdataformatet via response_format i forespørselen. Vi støtter MP3, WAV, OPUS, FLAC og PCM, slik at du kan tilpasse filstørrelse og kompatibilitet direkte i appen din uten ekstra konvertering.

Hastighetsjustering lar deg styre taletempoet mellom 0.25 og 4.0. Dette er nyttig for å tilpasse lyden til ulike innholdstyper, fra langsomme instruksjoner til raskere oppsummeringer.

Støttede formater: MP3, WAV, OPUS, FLAC, PCM

API-et returnerer lyd i det formatet du spesifiserer. MP3 er kompakt og bredt støttet, mens WAV gir ukomprimert kvalitet. Opus og PCM passer til videre prosessering.

  • MP3: Kompakt, universell kompatibilitet.
  • WAV & FLAC: Høy kvalitet uten tap.
  • PCM: Ukomprimert rådata for prosessering.

Hastighet fra 0.25 til 4.0

Du kontrollerer talehastigheten med speed-parameteren. Verdier mellom 0.25 og 4.0 gir deg fleksibilitet til å justere tempoet etter behov, enten det gjelder langsom lesing eller rask meddelelse.

Ved hastigheter over 1.0 kan opplevelsen oppleves som akselerert, mens verdier under 1.0 gir en mer rolig talestrøm.

Valgfritt språk ISO-kode

Hvis du ikke angir language, gjettes språket basert på skriftspråket. Tekst på latinsk skrift defaults til engelsk. For ikke-engelsk tekst på latin, må du sette language-parameteren eksplisitt for korrekt uttale.

Dette sikrer at stemmen din produserer korrekt aksent og intonasjon for det valgte språket.

Format og hastighet

Feilhåndtering

Illustrasjon av lydbølge for: Feilhåndtering

Når syntesen mislykkes, returneres ikke noe lydformat, men du betaler ikke for feilen. Dette sikrer at du kun betaler for lyd som faktisk produseres.

Hvis en feil oppstår under prosessen, returneres beløpet i fullt omfang. Du mister ingen kreditt for mislykkede forsøk.

Feil forespørsler er gratis

Vi debiterer kun for vellykkede forespørsler. Hvis serveren ikke klarer å generere lyd innen rimelig tid eller støtet mot en feil, er kostnaden 0.

  • Ingen kostnad for mislykkede genereringer
  • Kun vellykkede filer debiteres

Full refusjon ved feil

Hvis en feil oppstår under prosessen, returneres beløpet i fullt omfang. Du mister ingen kreditt for mislykkede forsøk.

Se feilkoder i responsen

HTTP-feilkoder (som 400 eller 500) indikerer problemet. Sjekk JSON-responsen for en detaljert beskrivelse av hva som gikk galt.

  • 400: Feil i input eller format
  • 401: Ugyldig API-nøkkel
  • 429: Rate limit overskredet
  • 500: Intern serverfeil

Rate limits

Illustrasjon av lydbølge for: Rate limits

API-et har faste grenser for hvor mange forespørsler du kan sende. Dette sikrer stabil ytelse for alle brukere, uavhengig av belastning på serveren.

Hvis du overskrider grensen, må du vente til neste minutt. Det er viktig å holde seg innenfor grensene for å unngå feil i applikasjonen din.

60 forespørsler i minuttet per nøkkel

Hver API-nøkkel tillater opptil 60 forespørsler per minutt. Dette er tilstrekkelig for de fleste applikasjoner og prosjekter, og gir deg mulighet til å sende mange tekstblokker raskt.

  • 60 forespørsler per minutt per nøkkel
  • Tilgjengelig for alle kontoer

10 forespørsler i minuttet før første top-up

Før du har lagt til midler på kontoen din, er grensen redusert til 10 forespørsler per minutt. Dette gir deg mulighet til å teste API-et uten å overstige grensen for raskt.

  • 10 forespørsler per minutt før top-up
  • Gyldig for nye kontoer

Vent i kø ved belastning

Hvis det er stor belastning på serveren, kan forespørsler bli lagret i en kø. Dette betyr at du kan få litt forsinkelse før lyden genereres fullstendig. Det er ingen garanti for øyeblikkelig respons.

Eksempler og kodesnutter

Illustrasjon av lydbølge for: Eksempler og kodesnutter

['Her er de mest brukte metodene for å integrere RøstKode i ditt prosjekt. Velg den løsningen som passer best med din tekniske stabel, fra enkel kommandolinje til fullstendige biblioteker.', 'Alle eksemplene nedenfor bruker tts-1 som standard modell. Husk å bytte ut DIN_NØKKEL med din egen nøkkel fra /get-api-key/, og juster base_url hvis du bruker et SDK.']

Lytt til de 8 stemmene

Hvert eksempel nedenfor er generert av dette API-et fra samme setning. MELLOMROM OG PUNKTUERING teller som tegn, så det er lurt å sjekke lengden på teksten din før du sender den.

Avatar for stemmen aria
ariakvinne
Avatar for stemmen nova
novakvinne
Avatar for stemmen luna
lunakvinne
Avatar for stemmen sage
sagekvinne
Avatar for stemmen felix
felixmann
Avatar for stemmen milo
milomann
Avatar for stemmen atlas
atlasmann
Avatar for stemmen orion
orionmann

23 språk

Hvilken som helst stemme kan tale ethvert av disse språkene.

Kilder og videre lesning

  1. Wikipedia
  2. LibriTTS-R paper (arXiv 2305.18802)
  3. Tether (USDT)
  4. LibriVox public-domain audiobooks
  5. FFmpeg documentation
  6. W3C WAI: making audio and video accessible
  7. curl documentation
  8. IETF RFC 7845: Ogg Opus
  9. openai-python on GitHub
  10. ISO 639 language codes
  11. Python documentation
  12. LibriTTS-R corpus (OpenSLR 141)

Mer på dette nettstedet