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.mp3Python (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 | |
|---|---|
aria | kvinne |
nova | kvinne |
luna | kvinne |
sage | kvinne |
felix | mann |
milo | mann |
atlas | mann |
orion | mann |
| language | |
|---|---|
ar | العربية |
zh | 中文 |
da | Dansk |
nl | Nederlands |
en | English |
fi | Suomi |
fr | Français |
de | Deutsch |
el | Ελληνικά |
he | עברית |
hi | हिन्दी |
it | Italiano |
ja | 日本語 |
ko | 한국어 |
ms | Bahasa Melayu |
no | Norsk |
pl | Polski |
pt | Português |
ru | Русский |
es | Español |
sw | Kiswahili |
sv | Svenska |
tr | Türkçe |
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/
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
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
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-1ellertts-1-hdsom 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
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
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
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.

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
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
['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.
23 språk
Hvilken som helst stemme kan tale ethvert av disse språkene.
