Endpoints

Tal (TTS)

Förvandla text till naturligt tal med POST /audio/speech, som returnerar råa ljudbytes i OpenAI-format, med röster, format, priser och exempel.

Testa i playground

Förvandla text till naturligt klingande tal (text-till-tal, TTS). Endpointen följer OpenAI:s POST /audio/speech och returnerar råa ljudbytes, så client.audio.speech.create(...) fungerar oförändrat.

POST https://api14.com/api/v1/audio/speech

Anrop

Parameter	Typ	Obligatorisk	Beskrivning
`model`	string	ja	Ett talmodell-id, t.ex. `openai/gpt-4o-mini-tts`.
`input`	string	ja	Texten som ska läsas upp.
`voice`	string	ja	Röstnamn, t.ex. `alloy`, `nova`, `verse`. Rösterna varierar mellan modeller (se modellsidan).
`response_format`	string	nej	`mp3` (standard), `wav`, `opus`, `aac`, `flac`, `pcm` där det stöds.
`speed`	number	nej	Uppspelningshastighet, vanligtvis `0.25`–`4.0`.
`instructions`	string	nej	Stilanvisningar för modeller som accepterar det ("lugn, varm ton").

Exempel

import { writeFile } from "node:fs/promises";
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

const audio = await client.audio.speech.create({
  "model": "openai/gpt-4o-mini-tts",
  "input": "Hello from api14! One API for every model.",
  "voice": "alloy",
  "response_format": "mp3"
});
await writeFile("speech.mp3", Buffer.from(await audio.arrayBuffer()));

Svar

Svaret är själva ljudfilen, med matchande Content-Type (t.ex. audio/mpeg). Spara den på disk eller strömma den till en spelare:

curl https://api14.com/api/v1/audio/speech \
  -H "Authorization: Bearer sk-api14-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/gpt-4o-mini-tts","input":"Hello from api14!","voice":"alloy"}' \
  --output hello.mp3

Fel returneras fortfarande som JSON i OpenAI:s felformat, så kontrollera statuskoden innan du skriver filen.

Priser

Tal faktureras per tecken i indata till modellens listade pris, som visas som "$ / 1M characters". Ett stycke på 1 000 tecken på en modell med priset 15 USD / 1M tecken kostar 0,015 USD.

Lista talmodeller

curl "https://api14.com/api/v1/models?category=speech"

Fel

Status	Kod	När
400	`model_required` / `invalid_json`	`model` saknas eller så är innehållet felaktigt.
402	`insufficient_balance`	Ditt USD-saldo är 0 USD.
403	`model_not_allowed` / `plan_required`	Nyckelns tillåtelselista eller plan utesluter modellen.
404	`model_not_found`	Okänt eller inaktiverat modell-id.
429	`rate_limited`	Gränsen för anrop per minut har överskridits.

Röster eller format som inte stöds avvisas uppströms och skickas vidare. Se Fel.