OpenAI TTS API
وصول API إلى OpenAI TTS لتحويل النص إلى كلام بزمن استجابة منخفض وجودة عالية، مع مخرجات MP3 يديرها RunAPI.
curl -X POST https://runapi.ai/api/v1/openai_tts/text_to_speech \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1-hd",
"text": "حوّل نص تعريف المستخدم بهذا المنتج إلى كلام واضح وطبيعي لجولة إرشادية داخل التطبيق."
}'
import { OpenaiTtsClient } from "@runapi.ai/openai-tts";
const client = new OpenaiTtsClient();
const result = await client.textToSpeech.run({
model: "tts-1-hd",
text: "حوّل نص تعريف المستخدم بهذا المنتج إلى كلام واضح وطبيعي لجولة إرشادية داخل التطبيق.",
});
require "runapi/openai_tts"
client = RunApi::OpenaiTts::Client.new
result = client.text_to_speech.run(
model: "tts-1-hd",
text: "حوّل نص تعريف المستخدم بهذا المنتج إلى كلام واضح وطبيعي لجولة إرشادية داخل التطبيق."
)
npx skills add runapi-ai/openai-tts -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
يحوّل OpenAI TTS النص إلى كلام عبر نقطة نهاية متزامنة في RunAPI. اختر tts-1 للتطبيقات الحساسة لزمن الاستجابة، أو tts-1-hd لسرد أعلى دقة؛ ويعيد كلاهما رابط URL لملف MP3 يديره RunAPI.
- عدة إصدارات لمستويات مختلفة من السرعة / الجودة
- يتضمن model skill التوثيق والـschemas وملاحظات الإعداد
- يعمل مع workflows موجهة لتطوير التطبيقات
- لا يتم احتساب رسوم على عمليات التوليد الفاشلة
قارن جميع إصدارات API
ثبّت skill OpenAI TTS لتطوير التطبيقات
حمّل توثيق النموذج والـschemas وملاحظات الأسعار وخطوات الإعداد إلى مساحة عمل الكود.
# Install the model skill for app development workflows
npx skills add runapi-ai/openai-tts -g
Install the OpenAI TTS skill for this app: 1. Add runapi-ai/openai-tts with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
من model skill إلى أول نتيجة في أربع خطوات
اختر النموذج
اختر النموذج والإصدار المناسبين لنوع المخرجات ومستوى الجودة وزمن الاستجابة المستهدف.
الإعداد
اضبط مفتاح RunAPI وثبّت model skill في مساحة عمل الكود.
التنفيذ
استخدم تعليمات المهارة لإضافة ميزة النموذج داخل تطبيقك.
الاستلام
استعلم عبر task ID أو استخدم البث عند دعمه أو عالج webhook callback.
ما هي OpenAI TTS API؟
يوفر OpenAI TTS نماذج متخصصة لتحويل النص إلى كلام، مناسبة للتشغيل التفاعلي والسرد الاحترافي. عبر RunAPI، تشترك النسختان في بنية طلب واحدة وتعيدان بيانات وصفية للصوت يديرها RunAPI.
لماذا تستخدم OpenAI TTS API عبر RunAPI
مصادقة واحدة لكل مزود
مفتاح RunAPI واحد يفتح الوصول إلى الكتالوج بالكامل. لا حسابات منفصلة، ولا تدوير مفاتيح لكل تكامل.
تسعير وفوترة موحّدان
تسعير لكل استدعاء بالدولار الأمريكي، ويُفوتر شهريًا. لا تُحتسب التوليدات الفاشلة.
Skill مع schemas
تأتي الـschemas المعرّفة وملاحظات الإعداد داخل model skill حتى يبدأ التنفيذ من العقد الصحيح.
أسئلة شائعة
ما الفرق بين tts-1 وtts-1-hd؟
يعطي tts-1 الأولوية لزمن الاستجابة المنخفض في التشغيل التفاعلي، بينما يعطي tts-1-hd الأولوية لجودة صوت أعلى للسرد والمحتوى النهائي.
ما تنسيق الصوت الذي يعيده OpenAI TTS؟
تعيد النسختان صوتًا بصيغة MP3، مع بيانات وصفية للتنسيق ونوع MIME وحجم الملف بالبايت في استجابة RunAPI.
هل تستضيف RunAPI الصوت المُنشأ؟
نعم. يتحقق RunAPI من سلامة الملف الصوتي ويعيد رابط URL يديره، بدلًا من كشف رابط URL مؤقت للمصدر.
هل يمكنني اختيار صوت أو سرعة مخصصين؟
تستخدم نقطة النهاية الأولية الصوت والسرعة الافتراضيين المعلنين. ولا يتضمن عقد نقطة النهاية هذا عناصر تحكم لتخصيص الصوت أو السرعة.
هل تحويل النص إلى كلام متزامن؟
نعم. يعيد الطلب الناجح النتيجة الصوتية المكتملة مباشرة، من دون نقطة نهاية منفصلة للاستعلام عن الحالة.
أي نسخة ينبغي أن أبدأ بها؟
اختر أرخص نسخة تفي بمعيار الجودة لديك. يبدأ معظم الفرق بالنسخة السريعة ثم ينتقلون إلى pro للإنتاج.
هل توجد خطة مجانية؟
تحصل الحسابات الجديدة على أول طلبات مجانية على كل نموذج. بعد ذلك، الدفع حسب كل طلب.
هل تدعمون البث المباشر للنتائج؟
حيث يتوفر البث المباشر، يوفّر RunAPI البث من البداية إلى النهاية.
كيف يتم احتساب الرسوم عند الفشل؟
لا يتم تحصيل رسوم على عمليات التوليد الفاشلة.
هل يتم تخزين المخرجات مؤقتًا؟
يتم حفظ المخرجات المولدة ويمكن استرجاعها بواسطة task ID. لا يتم تخزين المدخلات مؤقتًا.
هل يمكنني الاستخدام تجاريًا؟
نعم — يشمل كل إصدار الاستخدام التجاري ما لم يقيّده ترخيص النموذج صراحةً، ويُشار إلى ذلك في صفحة الإصدار.
ماذا عن حدود المعدل؟
تتدرج حدود المعدل لكل مفتاح وفق فئة الاستخدام. راجع صفحة الأسعار للاطلاع على الحدود الحالية.
أين يمكنني الإبلاغ عن المشاكل؟
افتح issue في مستودع GitHub العام أو راسل الدعم عبر البريد الإلكتروني.