تخطّي إلى المحتوى

OpenRouter [Audio]

التكامل

معرّف النموذج openrouter/router/audio
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/openrouter/router/audio?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "model": "google/gemini-3.8-flash"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

حتى ⁨‏1.858 $⁩ لكل تشغيل تُحتسب التكلفة حسب الاستخدام الفعلي، ويُسترد الباقي تشغيله في هذه الصفحة

الحصول على مفتاح API
OpenRouter LLM

نسخة بوابة LLM تعالج ملفًا صوتيًا للتفريغ أو التحليل باستخدام مطالبة

OpenRouter · نص

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب

الموجّه الذي يوجّه معالجة الصوت.

•مطلوب audio_url
أفلت ملفًا، أو

مدخل صوت للمعالجة، محدد بعنوان URL أو URI للبيانات. التنسيقات المقبولة هي m4a وflac وogg وaac وaiff وmp3 وwav.

•مطلوب

اسم يحدد النموذج المراد تشغيله.

متقدم system_prompt · temperature · max_tokens · reasoning · enable_web_search · web_search_options

موجّه النظام الذي يزوّد النموذج بالتعليمات أو السياق.

الافتراضي 1

تحكم في تنوع الاستجابة، حيث تضمن القيمة 0 إجابة متطابقة كلما لم يتغير المدخل. يؤدي رفع القيمة إلى إبعاد الاستجابات عن الإجابات المتوقعة والنمطية نحو تنوع أكبر وإجابات أقل شيوعًا.

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

إعداد البحث على الويب، بما في ذلك اختيار المحرك وحدود النتائج وتصفية النطاقات. يُستخدم فقط عندما تكون enable_web_search هي true.

POST /run/openrouter/router/audio?wait=20 عرض السعر → ⁨‏1.858 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/openrouter/router/audio?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "model": "google/gemini-3.8-flash"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول OpenRouter [Audio]

تقبل ملفًا صوتيًا عبر `audio_url` مع `prompt` و`model` مطلوب. التنسيقات المدرجة هي wav وmp3 وaiff وaac وogg وflac وm4a. تتوفر إعدادات اختيارية لـ `system_prompt` و`temperature` و`max_tokens` و`reasoning` والبحث على الويب. تعيد نصًا واستخدام الرموز.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
audio_urlمطلوب audio
النوعurl · audio
مدخل صوت للمعالجة، محدد بعنوان URL أو URI للبيانات. التنسيقات المقبولة هي m4a وflac وogg وaac وaiff وmp3 وwav.
promptمطلوب
النوعstring
الموجّه الذي يوجّه معالجة الصوت.
system_promptاختياري
النوعstring | null
موجّه النظام الذي يزوّد النموذج بالتعليمات أو السياق.
modelمطلوب
النوعstring
اسم يحدد النموذج المراد تشغيله.
reasoningاختياري
النوعboolean
الافتراضيfalse
ما إذا كان ينبغي تضمين الاستدلال في الاستجابة النهائية.
temperatureاختياري
النوعnumber
الافتراضي1
0 – 2
تحكم في تنوع الاستجابة، حيث تضمن القيمة 0 إجابة متطابقة كلما لم يتغير المدخل. يؤدي رفع القيمة إلى إبعاد الاستجابات عن الإجابات المتوقعة والنمطية نحو تنوع أكبر وإجابات أقل شيوعًا.
max_tokensاختياري
النوعinteger | null
≥ 1
حدّد عدد الرموز المولّدة في الاستجابة بقيمة لا تتجاوز طول السياق ناقص طول الموجّه. لا يمكن أن يتجاوز التوليد هذا الحد.
web_search_optionsاختياري
النوعobject
إعداد البحث على الويب، بما في ذلك اختيار المحرك وحدود النتائج وتصفية النطاقات. يُستخدم فقط عندما تكون enable_web_search هي true.
web_search_options.engineاختياري
النوعenum
الافتراضيauto
autonativeexa
اختيار محرك البحث: يعود 'auto' و'native' كلاهما إلى Exa عند عدم توفر البحث الأصلي. يستخدم 'auto' بحث الموفر الأصلي المتاح؛ ويفضل 'native' البحث المضمّن من OpenAI أو Anthropic أو Google أو xAI أو Perplexity. لاستخدام API البحث في Exa حصريًا، اختر 'exa'.
web_search_options.max_resultsاختياري
النوعinteger | null
1 – 25
حد النتائج لكل استدعاء بحث في Exa، من 1 إلى 25، مع قيمة افتراضية 5. يتجاهل بحث الموفر الأصلي هذا الإعداد.
web_search_options.max_usesاختياري
النوعinteger | null
≥ 1
حد البحث لكل طلب، يُرسل إلى Anthropic للبحث الأصلي لكن يتجاهله الموفرون الأصليون الآخرون. تتلقى الاستدعاءات التي تتجاوز الحد نتيجة خطأ ولا تُشغّل.
web_search_options.max_total_resultsاختياري
النوعinteger | null
≥ 1
الحد الإجمالي للنتائج لجميع عمليات البحث ضمن طلب واحد.
web_search_options.search_context_sizeاختياري
النوعenum
lowmediumhigh
كمية الاسترجاع لكل نتيجة في Exa، ويتجاوزها max_characters عند تقديم كليهما، ويُتجاهل في بحث الموفر الأصلي. اختر low لـ 5K حرف، أو medium لـ 15K، أو high لـ 30K؛ ويتيح عدم تحديده لـ Exa تكييف الكمية إلى نحو 2–4K لكل نتيجة.
web_search_options.max_charactersاختياري
النوعinteger | null
1 – 100,000
الحد الأقصى لأحرف المحتوى لكل نتيجة في Exa، ويتجاوز search_context_size عند تقديم الإعدادين. اضبط حدًا أقصى دقيقًا من 1 إلى 100,000 حرف؛ ويتجاهل بحث الموفر الأصلي هذا الإعداد.
web_search_options.allowed_domainsاختياري
النوعstring[]
قائمة السماح بالنطاقات لـ Exa ومعظم موفري البحث الأصلي، لتقييد النتائج بالنطاقات المدرجة. لا يدعم بحث Google الأصلي ذلك.
web_search_options.excluded_domainsاختياري
النوعstring[]
قائمة استبعاد النطاقات لعمليات بحث Exa والموفرين الأصليين المتوافقين؛ ولا يمكن لبحثي Google وOpenAI الأصليين تطبيق هذه القائمة. تُستبعد النتائج الصادرة من النطاقات المدرجة.
web_search_options.user_locationاختياري
النوعobject
الموقع التقريبي للمستخدم الذي يوجّه نتائج البحث الأصلي جغرافيًا؛ لا تستخدم Exa هذه المعلومات.
web_search_options.user_location.typeاختياري
النوعstring
الافتراضيapproximate
تصنيف الموقع؛ القيمة المدعومة الوحيدة هي 'approximate'.
web_search_options.user_location.cityاختياري
النوعstring | null
اسم المدينة، مثل 'San Francisco'.
web_search_options.user_location.regionاختياري
النوعstring | null
اسم الولاية أو المنطقة، مثل 'California'.
web_search_options.user_location.countryاختياري
النوعstring | null
معرّف البلد المعبّر عنه بحرفين، مثل 'US'.
web_search_options.user_location.timezoneاختياري
النوعstring | null
معرّف المنطقة الزمنية بتدوين IANA، مثل 'America/Los_Angeles'.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "openrouter/router/audio",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1858,
    "usd": "1.858",
    "charged": 1858,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "model": "google/gemini-3.8-flash"
  },
  "output": {
    "output": "The audio contains a conversation between two people discussing the weather forecast for the upcoming week.",
    "usage": {
      "prompt_tokens": 1,
      "completion_tokens": 1,
      "total_tokens": 0,
      "cost": 1.0,
      "prompt_tokens_details": {
        "cached_tokens": 0,
        "cache_write_tokens": 0
      }
    }
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
output
stringالنتيجة الناتجة عن معالجة الصوت.
usage
object {prompt_tokens, completion_tokens, total_tokens, cost, prompt_tokens_details} | nullتفاصيل استهلاك الرموز.

مزيد من النماذج: LLM

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/openrouter/router/audio.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt