Endpoints
स्पीच (TTS)
POST /audio/speech से टेक्स्ट को प्राकृतिक आवाज़ में बदलें और कच्चे ऑडियो बाइट पाएँ। पैरामीटर, फ़ॉर्मेट, कीमत और त्रुटियाँ यहाँ हैं।
playground में आज़माएंटेक्स्ट को प्राकृतिक लगने वाली आवाज़ में बदलें (text-to-speech, TTS)। एंडपॉइंट OpenAI के POST /audio/speech की संरचना का पालन करता है और कच्चे ऑडियो बाइट लौटाता है, इसलिए client.audio.speech.create(...) बिना बदलाव के काम करता है।
POST https://api14.com/api/v1/audio/speech
अनुरोध
| पैरामीटर | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
model | string | हाँ | स्पीच मॉडल id, जैसे openai/gpt-4o-mini-tts। |
input | string | हाँ | बोला जाने वाला टेक्स्ट। |
voice | string | हाँ | आवाज़ का नाम, जैसे alloy, nova, verse। आवाज़ें मॉडल के अनुसार बदलती हैं (मॉडल पेज देखें)। |
response_format | string | नहीं | mp3 (डिफ़ॉल्ट), wav, opus, aac, flac, pcm, जहाँ समर्थित हो। |
speed | number | नहीं | प्लेबैक गति, आमतौर पर 0.25-4.0। |
instructions | string | नहीं | उन मॉडल के लिए शैली निर्देश जो इसे स्वीकार करते हैं ("शांत, गर्मजोशी भरा लहजा")। |
उदाहरण
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()));
प्रतिक्रिया
बॉडी खुद ऑडियो फ़ाइल है, मेल खाते Content-Type (जैसे audio/mpeg) के साथ। इसे डिस्क पर सहेजें या प्लेयर में स्ट्रीम करें:
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
त्रुटियाँ फिर भी OpenAI त्रुटि संरचना में JSON के रूप में लौटती हैं, इसलिए फ़ाइल लिखने से पहले स्टेटस कोड जाँचें।
कीमत
स्पीच का बिल प्रति इनपुट अक्षर मॉडल की सूचीबद्ध कीमत पर बनता है, जो "$ / 1M characters" के रूप में दिखती है। $15 / 1M अक्षर की कीमत वाले मॉडल पर 1,000 अक्षर के पैराग्राफ़ की लागत $0.015 है।
स्पीच मॉडल सूचीबद्ध करना
curl "https://api14.com/api/v1/models?category=speech"
त्रुटियाँ
| स्टेटस | कोड | कब |
|---|---|---|
| 400 | model_required / invalid_json | model गायब या बॉडी गलत रूप में। |
| 402 | insufficient_balance | आपका USD बैलेंस $0 है। |
| 403 | model_not_allowed / plan_required | कुंजी की allowlist या प्लान में मॉडल शामिल नहीं। |
| 404 | model_not_found | अज्ञात या अक्षम मॉडल id। |
| 429 | rate_limited | प्रति मिनट अनुरोध सीमा पार हो गई। |
असमर्थित आवाज़ें या फ़ॉर्मेट अपस्ट्रीम में अस्वीकार होते हैं और आगे पास किए जाते हैं। देखें त्रुटियाँ।