Google · صوت وموسيقى

OpenClaw x Gemini TTS

يندرج Gemini TTS ضمن كتالوج Google على RunAPI، ويتيح Gemini 2.5 Pro TTS وGemini 3.1 Flash TTS عبر واجهات موحّدة لـ API وSDK وCLI.

2 variants ابتداءً من $1.40 / مليون رمز مسموح للاستخدام التجاري

Prerequisite: npx runapi mcp install

Prompt

نماذج Prompt

استخدم gemini-2.5-pro-tts عندما يناسب المهمة: كلام متعدد المتحدثين بجودة صوت عالية مع تحكم تعبيري للحوارات الطويلة.

You have access to RunAPI task tools for Gemini TTS.

Available Gemini TTS models:
- gemini-2.5-pro-tts: كلام متعدد المتحدثين بجودة صوت عالية مع تحكم تعبيري للحوارات الطويلة
  endpoints: /api/v1/gemini_tts/text_to_speech
  request fields: model, temperature, scene, sample_context, speakers, dialogue_turns
- gemini-3.1-flash-tts: كلام سريع متعدد المتحدثين للحوارات التفاعلية وأحمال الصوت الكبيرة
  endpoints: /api/v1/gemini_tts/text_to_speech
  request fields: model, temperature, scene, sample_context, speakers, dialogue_turns

Use the model ID and endpoint that match the user's request.
Example prompt: أنشئ مقدمة بودكاست بمتحدثين اثنين، مقدم بريطاني هادئ وضيف أمريكي حيوي.
/api/v1/gemini_tts/text_to_speech: Submit the task, poll for its status, then verify the completed output. أرسل POST إلى /api/v1/gemini_tts/text_to_speech واحفظ معرّف Task المُعاد.
أرسل GET إلى /api/v1/gemini_tts/text_to_speech/<task-id> حتى تصبح الحالة completed أو failed.
تحقق من أن استجابة completed تحتوي على المخرجات الخاصة بنقطة النهاية والموثقة في مرجع API.

الإصدارات ونقاط النهاية العامة

معرّف النموذج نقاط النهاية السعر الابتدائي الكتالوج
gemini-2.5-pro-tts
/api/v1/gemini_tts/text_to_speech
$1.40 / مليون رمز تفاصيل النموذج
gemini-3.1-flash-tts
/api/v1/gemini_tts/text_to_speech
$1.40 / مليون رمز تفاصيل النموذج

التحقق

استعلم حتى تصل المهمة إلى حالة نهائية

اختر <model-id> لإنشاء أوامر التحقق.

الإعداد

نقطة نهاية الدليل: <endpoint>

اختر <model-id> لإنشاء طلب وفق عقد الإدخال العام لنقطة النهاية.
آلية العمل

ابدأ في 3 خطوات

  1. اختر معرّف نموذج

    اختر معرّف نموذج عامًا من الكتالوج وراجع نقطة النهاية وسعر البداية الحالي.

  2. اضبط RunAPI

    اضبط RUNAPI_API_KEY قبل إرسال الطلب إلى نقطة النهاية.

  3. تحقق من النتيجة

    لنقاط النهاية غير المتزامنة، استعلم من نقطة النهاية نفسها حتى تصل Task إلى حالة نهائية.

ما الذي يمكنك بناؤه باستخدام OpenClaw + Gemini TTS

  • التعليق الصوتي والسرد

    حوّل النصوص إلى صوت منطوق لمقاطع الفيديو والدورات التعليمية وعروض المنتجات باستخدام نماذج تولّد الكلام.

  • الموسيقى والمقاطع الصوتية المصاحبة

    أنشئ موسيقى خلفية وجينغلات من وصف للنوع الموسيقي والأجواء والإيقاع باستخدام نماذج تولّد الموسيقى.

  • التفريغ النصي ومعالجة الصوت

    فرّغ التسجيلات نصيًا أو نظّف الصوت الموجود وحوّله باستخدام نماذج تقبل الصوت كمدخل.

لماذا تستخدم Gemini TTS عبر RunAPI + OpenClaw

  • 2 نماذج، ومفتاح API واحد

    استخدم اتصالاً واحداً مع RunAPI للاختيار بين نماذج متاحة من دون تغيير تكاملك.

  • أسعار استخدام واضحة

    اطّلع على أسعار الكتالوج الحالية قبل إرسال الطلب، من دون اشتراك أو حد أدنى للإنفاق.

  • سير عمل تلقائي للمهام

    أرسل المهام غير المتزامنة واستعلم عن حالتها واجمع نتائجها عبر سير عمل موحّد من دون كتابة كود استطلاع يدوي.

أسئلة حول OpenClaw وGemini TTS

ما نماذج Gemini TTS المتاحة؟

يدعم RunAPI Gemini 2.5 Pro TTS وGemini 3.1 Flash TTS من خلال نفس نقطة نهاية تحويل النص إلى كلام وبنية الطلب نفسها.

كيف أضبط إعدادات عدة متحدثين؟

أضف إعدادًا لكل مشارك باستخدام معرّف فريد بصيغة Speaker N، ثم اربط كل دور في الحوار بأحد هذه المعرّفات.

ما الذي يمكنني التحكم به لكل متحدث؟

لكل متحدث صوت ولهجة وأسلوب إلقاء وإيقاع كلام، مع ملف تعريف صوتي اختياري لإضافة توجيهات صوتية.

كيف يؤثر المشهد وسياق العينة في الطلب؟

يصف المشهد بيئة التسجيل، بينما يحدد سياق العينة النبرة العامة وتوجيهات إلقاء الحوار.

كيف تُعاد النتائج الصوتية المكتملة؟

استعلم عن المهمة أو استقبل رد الاتصال عند اكتمالها؛ وتتضمن الاستجابة قائمة audios تحتوي على رابط URL للملف المُنشأ.

أي معرّف نموذج أستخدم؟

اختر معرّف نموذج عامًا من جدول الإصدارات. يعرض كل معرّف نقاط النهاية الموضحة في صفه.

هل يضبط هذا الدليل نموذج محادثة؟

لا. يستخدم Model Line هذا مسار نقطة النهاية الموضح هنا ولا يُعرض كنموذج محادثة للوكيل.

هل تبنون مع فريق؟

نساعدكم في إعدادات المؤسسات والتكاملات والأسئلة التقنية.

تواصل معنا