# مصادر التسجيل وإعدادات التفريغ

> تعرف على الروابط المدعومة، واختر بين الترجمة النصية والتفريغ الصوتي بالذكاء الاصطناعي، واضبط اللغة وتمييز المتحدثين.

Canonical: https://transcript1.com/ar/docs/sources-and-options
Language: ar
Last updated: 2026-10-20

أرسل رابط فيديو من YouTube أو X أو TikTok أو Instagram أو Facebook أو Bluesky، أو ارفع ملفك. يدعم transcript1 أيضا التسجيلات العامة من المنصات الإضافية في الجدول. لضبط التفريغ، أضف `source` و`diarize` و`language` إلى body في `POST /v1/transcriptions`. هذه الحقول اختيارية؛ تحدد مصدر النص وتمييز المتحدثين واللغة.

## ما الروابط التي يمكنك إرسالها؟

ضع الرابط في `url`؛ يتعرف API على المنصة تلقائيا. يمكنك تحديد `platform` بنفسك، لكن يجب أن تتوافق قيمته مع الرابط.

| المنصة | صيغ الروابط المقبولة |
|---|---|
| YouTube (`youtube`) | صيغ روابط الفيديو موضحة في القسم التالي. |
| X (`x`) | رابط منشور يحتوي على فيديو من `x.com` أو `twitter.com`، مثل `https://x.com/user/status/1234567890`. |
| TikTok (`tiktok`) | رابط فيديو من `tiktok.com`، أو رابط قصير من `vm.tiktok.com` أو `vt.tiktok.com` أو `www.tiktok.com/t/`. |
| Instagram (`instagram`) | رابط ريلز أو منشور فيديو من `instagram.com` بالمسارات `/reel/` أو `/reels/` أو `/p/` أو `/tv/`. تقبل أيضا روابط الريلز والمنشورات التي يسبق مسارها اسم المستخدم. |
| Facebook (`facebook`) | روابط الفيديو والريلز على `facebook.com`، ومنها روابط watch. تقبل أيضا `fb.watch` والروابط القصيرة بالمسارين `/share/v/` و`/share/r/`. |
| Bluesky (`bluesky`) | رابط منشور فيديو من `bsky.app`، مثل `https://bsky.app/profile/user.example/post/3l3w4b5c6d7e2`. |
| [Twitch](https://transcript1.com/ar/features/tafrigh-bath-twitch) (`twitch`) | تسجيل VOD بعد انتهاء البث على `twitch.tv/videos/<id>` أو `/<channel>/v/<id>`؛ يمكن استخدام `video` أيضا. وللمقاطع، استخدم `clips.twitch.tv/<slug>` أو `twitch.tv/<channel>/clip/<slug>` أو `/clip/<slug>`. المضيفون المقبولون هم `twitch.tv` و`www` و`m` و`go` و`clips.twitch.tv`. |
| [Dailymotion](https://transcript1.com/ar/features/tafrigh-fidyu-dailymotion) (`dailymotion`) | رابط `dailymotion.com/video/<id>` مع `_title` اختياري، أو `/embed/video/<id>`، أو `dai.ly/<id>`. تقبل أيضا الروابط من `www.dailymotion.com` و`touch.dailymotion.com`. |
| [Pinterest](https://transcript1.com/ar/features/tafrigh-fidyu-pinterest) (`pinterest`) | Pin يحتوي على فيديو مرفوع مباشرة إلى `pinterest.com` أو `www.pinterest.com`، بمسار `/pin/<id>/` أو `/pin/<slug>--<id>/`. نأخذ أول فيديو مرفوع إلى المنصة داخل المنشور. لا نقبل الفيديو المضمن من موقع آخر أو الصور أو اللوحات أو `pin.it` أو النطاقات الإقليمية. |
| [LinkedIn](https://transcript1.com/ar/features/tafrigh-fidyu-linkedin) (`linkedin`) | منشور فيديو عام على `linkedin.com` أو `www.linkedin.com` بمسار `/posts/<slug>-<activity-id>-<four-character-suffix>` أو `/feed/update/urn:li:activity:<id>/`. روابط الملفات الشخصية وLearning والفعاليات و`lnkd.in` غير مدعومة. |
| [Snapchat Spotlight](https://transcript1.com/ar/features/tafrigh-snapchat-spotlight) (`snapchat`) | فيديو Spotlight على `snapchat.com` أو `www.snapchat.com` بمسار `/spotlight/<id>`. لا تقبل روابط القصص أو الملفات الشخصية. |

للمنصات الخمس الإضافية، استخدم HTTPS دون بيانات دخول في الرابط أو منفذ مخصص. أرسل رابط تسجيل عام واحد، لا ملفا شخصيا أو موجز منشورات أو مجموعة. لن تعمل المنشورات الخاصة أو التي تتطلب تسجيل الدخول، ولا البث المباشر أو الذي ما زال قيد المعالجة. لا نرسل cookies لأي حساب. معاملات الوقت في الرابط لا تقص التسجيل. وقد تكون قيمة `media_id` لمقاطع Twitch وSnapchat Spotlight بصيغة لا يمكن استنتاجها من الرابط؛ احتفظ بها كما أعادها API.

على X وTikTok وInstagram وFacebook وBluesky، يجب أن يكون المنشور عاما. وإذا احتوى على عدة فيديوهات، نفرغ الأول فقط. لا تقبل روابط الملفات الشخصية أو القصص أو صفحات البث المباشر أو منشورات الصور في TikTok. إذا طلبت المنصة تسجيل الدخول، تحصل على `login_required`. وإذا لم يكن للفيديو مسار صوتي، تحصل على `no_audio`. لا تدفع في الحالتين.

يمكن جلب الترجمة النصية من YouTube وX وTikTok وBluesky وDailymotion وLinkedIn إذا توفر مسار مناسب بلغة الفيديو الأصلية. أما Instagram وFacebook وTwitch وPinterest وSnapchat، فتقبل `auto` أو `stt` للتفريغ الصوتي بالذكاء الاصطناعي، وترفض `captions`. توفر الترجمة النصية يعتمد على الفيديو. سعر الدقيقة واحد للروابط والملفات، وتحسب التكلفة حسب المدة المقاسة. للروابط القصيرة، التزم بالصيغ الواردة في الجدول. وإذا أردت إعادة استخدام نص سابق، أرسل رابط المنشور الكامل؛ لا يمكن مطابقة رابط مشاركة لا يتضمن معرف المنشور وقت الإرسال بنص مفرغ سابق.

| المنصة | الترجمة النصية والتوقيت المتاح |
|---|---|
| YouTube وX | نستخدم مسارات الترجمة النصية الموجودة. توقيت كل كلمة متاح فقط مع الترجمة النصية المنشأة تلقائيا في YouTube. |
| TikTok | نستخدم الترجمة النصية المتاحة على المنصة بصيغة VTT أو SRT، مع توقيت المقاطع فقط. |
| Bluesky | نستخدم مسارات الفيديو على PDS الموثوق الذي ندعمه. لا نقبل مضيفي الاتحاد الآخرين بشكل عام، أو الفيديو المقتبس أو الخارجي. التوقيت للمقاطع فقط. |
| Dailymotion | نقبل ملفات SRT المباشرة، لا قوائم تشغيل الترجمة النصية. التوقيت للمقاطع فقط. المسارات التي نتعرف عليها بوصفها en-auto/fr-auto تحمل القيمة auto_generated. |
| LinkedIn | ندعم منشورات الفيديو العامة المرفوعة إلى المنصة، لا LinkedIn Learning. مسارات VTT المتاحة تعطي توقيت المقاطع فقط. |

## صيغ رابط YouTube

أرسل رابط الفيديو في `url`، مع `platform` بقيمة `youtube` أو من دونه. تقبل الصيغ التالية سواء أضفت `www.` أم لم تضفه:

| نوع الرابط | مثال |
|---|---|
| صفحة المشاهدة | `https://www.youtube.com/watch?v=dQw4w9WgXcQ` |
| رابط قصير | `https://youtu.be/dQw4w9WgXcQ` |
| Shorts | `https://www.youtube.com/shorts/dQw4w9WgXcQ` |
| رابط التضمين | `https://www.youtube.com/embed/dQw4w9WgXcQ` |
| مسار live | `https://www.youtube.com/live/dQw4w9WgXcQ` |
| نطاق الجوال أو الموسيقى | `https://m.youtube.com/watch?v=dQw4w9WgXcQ`، `https://music.youtube.com/watch?v=dQw4w9WgXcQ` |

لا تغير معاملات query الإضافية مثل `t` و`list` و`si` الفيديو الذي نعالجه؛ نتجاهلها ونطابق جميع صيغ الرابط مع الفيديو نفسه. أرسل الرابط كاملا، لا معرف الفيديو وحده المكون من 11 حرفا. تعيد صفحات القنوات وروابط قوائم التشغيل دون فيديو والروابط غير المدعومة `422 invalid_url`. وإذا أرسلت قيمة غير معروفة في `platform`، تحصل على `422 unsupported_platform` مع قائمة `supported_platforms`.

يجب أن يكون فيديو YouTube عاما أو غير مدرج. الفيديو الخاص يعطي `media_private`، والمقيد بالعمر `age_restricted`، والبث المباشر `live_stream`. إذا كان الملف لديك، يمكنك [رفعه مباشرة](https://transcript1.com/ar/docs/uploads).

## source

اختر من أين يأتي النص المفرغ عبر `source`:

| القيمة | كيف نحصل على النص |
|---|---|
| `auto` وهو الافتراضي | نبحث أولا عن ترجمة نصية مناسبة بلغة الفيديو الأصلية على YouTube وX وTikTok وBluesky وDailymotion وLinkedIn. إن لم تتوفر، نستخدم التفريغ الصوتي بالذكاء الاصطناعي. |
| `captions` (الترجمة النصية فقط) | نجلب الترجمة النصية من المنصات التي تدعمها، دون تنزيل الصوت أو استخدام التفريغ الصوتي بالذكاء الاصطناعي. إذا لم نجد مسارا مناسبا، يفشل التفريغ بالرمز `no_captions` ولا تدفع شيئا. وإذا فشل تنزيل محتوى الترجمة النصية، تحصل على `fetch_failed`. بقية منصات الروابط ترفض هذا الخيار بالرمز `422 invalid_request`. |
| `stt` | نستخدم التفريغ الصوتي بالذكاء الاصطناعي مباشرة في كل مرة. |

للملفات المرفوعة، نستخدم تحويل الصوت إلى نص دائما. تقبل `source` هنا `auto` أو `stt` فقط؛ أما `captions` فيعيد `422 invalid_request`.

نختار مسار الترجمة النصية باللغة التي طلبتها، أو بلغة الفيديو الأصلية عند `language=auto`. في YouTube، نستخدم المسار الذي رفعه صانع المحتوى أو أنشأه YouTube بتلك اللغة، ولا نستخدم مسارا مترجما آليا من لغة أخرى. الأولوية للترجمة النصية التي رفعها صانع المحتوى، ثم للمسار مجهول المصدر، ثم للترجمة النصية المنشأة تلقائيا. لا تفترض أن المسار مجهول المصدر من إعداد صانع المحتوى.

في X، نستخدم مسارات VTT المتاحة. تعطي توقيت المقاطع فقط، حتى لو أنشئت تلقائيا. ينتقل `auto` إلى STT إذا تعذر الحصول على محتوى الترجمة النصية أو تحليله، وليس لمعالجة أخطاء التوجيه أو التخزين أو البرمجة. ومع `stt`، نتجاوز الترجمة النصية من البداية.

## diarize

لتمييز المتحدثين، فعل `diarize`. الإعداد الافتراضي هو `false`.

- يتطلب تمييز المتحدثين تحويل الصوت إلى نص. لذلك، مع `source=auto` و`diarize: true` نستخدم الصوت مباشرة ولا نجلب الترجمة النصية.
- لا يمكن الجمع بين `source: "captions"` و`diarize: true`؛ يعيد API الرمز `422 invalid_request`.
- تحصل على تسميات مثل `Speaker 1` و`Speaker 2` في `transcript.speakers` وحقل `speaker` لكل مقطع. وفي `text` و`srt`، تسبق الكلام بادئة مثل `Speaker 1: `. أما `vtt`، فيستخدم وسم الصوت `<v Speaker 1>`.

```json
{ "platform": "youtube", "url": "https://youtu.be/dQw4w9WgXcQ", "source": "stt", "diarize": true }
```

## language

اترك `language` على `auto`، وهو الافتراضي، أو أرسل رمز ISO 639-1 من حرفين مثل `en` أو `de` أو `es`.

- عند جلب الترجمة النصية، تحدد القيمة لغة المسار. ومع `auto`، نختار لغة الفيديو الأصلية.
- عند تحويل الصوت إلى نص، نرسل القيمة إلى مزود التفريغ كتلميح للغة. ومع `auto`، يجري التعرف على اللغة تلقائيا ويحتوي كل مقطع على حقل `language` الخاص به.

أما حقل `language` في كائن التفريغ نفسه، فيبين اللغة الغالبة في التسجيل.

## كيف تقرأ مصدر النص وتوقيته؟

يعرفك `transcript_source` بمصدر النص المفرغ. قيمه هي `youtube_captions` أو `x_captions` أو `tiktok_captions` أو `bluesky_captions` أو `dailymotion_captions` أو `linkedin_captions` أو `speech_to_text`. للترجمة النصية، يوضح `caption_kind` نوع المسار بقيمة `manual` أو `auto_generated`. وتعني `null` أن مصدر المسار مجهول، لا أن صانع المحتوى رفعه.

| | `youtube_captions` مع `caption_kind` بقيمة `manual` | `youtube_captions` مع `caption_kind` بقيمة `auto_generated` | `speech_to_text` |
|---|---|---|---|
| تقسيم المقاطع | مقطع لكل وحدة توقيت في ملف الترجمة النصية | مقطع لكل وحدة توقيت في ملف الترجمة النصية | يبدأ مقطع جديد عند تغير المتحدث أو اللغة أو نهاية الجملة، أو بلوغ 15 ثانية |
| توقيت كل كلمة مع `include=words` | غير متاح؛ `words` تساوي `null` | بداية كل كلمة، ونهايتها عند بداية الكلمة التالية | بداية كل كلمة ونهايتها، مع `confidence` |
| تمييز المتحدثين | غير متاح | غير متاح | متاح مع `diarize` بقيمة `true` |
| اللغة | لغة المسار | لغة المسار | لغة كل مقطع على حدة |

نحتفظ بنص الترجمة النصية كما نشره YouTube، بما فيه علامات مثل `[Music]`. الحد الأقصى لتحويل الصوت إلى نص هو 5 ساعات؛ إذا تجاوز التسجيل ذلك، يفشل التفريغ بالرمز `media_too_long`.

الترجمة النصية من X (`x_captions`) وTikTok وBluesky وDailymotion وLinkedIn تعطي توقيت المقاطع فقط، ولا تميز المتحدثين. حتى مع `include=words`، تحصل على `words: null` لكل مقطع، بما في ذلك المسارات المنشأة تلقائيا. للحصول على توقيت كل كلمة بالذكاء الاصطناعي، اختر `source: "stt"`. ولتمييز المتحدثين، استخدم `diarize: true` مع `auto` أو `stt`.

## هل يختلف السعر حسب المصدر؟

لا. تدفع وحدة رصيد واحدة لكل دقيقة من التسجيل، ونحسب أي جزء من الدقيقة كدقيقة كاملة، سواء جلبنا الترجمة النصية أو فرغنا الصوت. اختيار `source` يغير مصدر النص، لا سعره. التفاصيل في [الفوترة وحدود الاستخدام](https://transcript1.com/ar/docs/billing-and-limits).