Uç noktalar

Konuşma sentezi

POST /audio/speech ile metni doğal sesli konuşmaya (TTS) çevirin; ses, format ve hız parametreleri, ham ses yanıtı ve karakter başına fiyatlandırma.

Playground’da dene

Metni doğal sesli konuşmaya çevirin (text-to-speech, TTS). Uç nokta OpenAI'ın POST /audio/speech yapısını izler ve ham ses baytlarını döndürür; bu yüzden client.audio.speech.create(...) değişiklik yapmadan çalışır.

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

İstek

Parametre	Tür	Zorunlu	Açıklama
`model`	string	evet	Bir konuşma modeli kimliği, örn. `openai/gpt-4o-mini-tts`.
`input`	string	evet	Seslendirilecek metin.
`voice`	string	evet	Ses adı, örn. `alloy`, `nova`, `verse`. Sesler modele göre değişir (model sayfasına bakın).
`response_format`	string	hayır	Desteklenen yerlerde `mp3` (varsayılan), `wav`, `opus`, `aac`, `flac`, `pcm`.
`speed`	number	hayır	Oynatma hızı, genellikle `0.25`–`4.0`.
`instructions`	string	hayır	Bunu kabul eden modeller için stil yönergesi ("sakin, sıcak bir ton").

Örnek

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()));

Yanıt

Gövde, ses dosyasının kendisidir ve eşleşen bir Content-Type ile gelir (örn. audio/mpeg). Diske kaydedin veya bir oynatıcıya stream edin:

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

Hatalar yine OpenAI hata yapısında JSON olarak döner; bu yüzden dosyayı yazmadan önce durum kodunu kontrol edin.

Fiyatlandırma

Konuşma, modelin listelenen fiyatı üzerinden girdi karakteri başına faturalandırılır ve "$ / 1M karakter" olarak gösterilir. 1 milyon karakter başına 15 $ fiyatlı bir modelde 1.000 karakterlik bir paragraf 0,015 $ tutar.

Konuşma modellerini listeleme

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

Hatalar

Durum	Kod	Ne zaman
400	`model_required` / `invalid_json`	`model` eksik veya gövde hatalı.
402	`insufficient_balance`	USD bakiyeniz 0.
403	`model_not_allowed` / `plan_required`	Anahtar izin listesi veya plan modeli dışlıyor.
404	`model_not_found`	Bilinmeyen veya devre dışı model kimliği.
429	`rate_limited`	Dakikalık istek limiti aşıldı.

Desteklenmeyen sesler veya formatlar sağlayıcı tarafında reddedilir ve aynen iletilir. Bkz. Hatalar.