كيف يمكنني توليد فيديو أفاتار بالذكاء الاصطناعي باستخدام VisionStory API؟

أنشئ مفتاح VisionStory API، وتحقق من النقاط لديك، واجلب معرّفات النموذج والأفاتار والصوت الحالية، ثم أرسل إمّا text_script أو audio_script عبر POST /api/v1/video. تعيد الواجهة معرّف الفيديو فورًا. استعلم عن حالة المهمة كل 5 ثوانٍ تقريبًا حتى تصبح created، ثم نزّل ملف MP4 من video_url.

هل ينبغي أن أستخدم REST API أم Python SDK أم CLI؟

استخدم REST عندما تحتاج إلى تحكم مستقل عن اللغة، واستخدم Python SDK عند بناء خدمة Python أو دفتر ملاحظات، واستخدم CLI لأتمتة الطرفية وCI أو التوليد على دفعات. تستخدم الواجهات الثلاث الموارد نفسها في VisionStory وسير عمل الفيديو غير المتزامن.

هل يمكن لـ Codex أو Claude Code أو Cursor إنشاء فيديوهات أفاتار لي؟

نعم. ثبّت VisionStory Agent Skill أو صِل بخادم VisionStory MCP. يمكن لوكيل برمجة مدعوم التحقق من النقاط، وعرض النماذج والأفاتارات والأصوات الحالية، وتجهيز طلب صالح، وبدء مهمة الفيديو، ومراقبتها، وتنزيل النتيجة مع بقاء مفتاح API في بيئتك أو في مخزن أسرار MCP.

هل يمكنني إنشاء فيديوهات أفاتار من الصوت بدلًا من النص؟

نعم. أرسل audio_script عندما تريد أن يتحدث الأفاتار من صوت مسجّل، أو أرسل text_script مع معرّف صوت عندما يجب على VisionStory توليد الكلام. استخدم نوعًا واحدًا من النصوص لكل طلب بدلًا من إرسال الاثنين معًا.

كيف يجب أن يتعامل التكامل في بيئة الإنتاج مع توليد الفيديو؟

اعتبر إنشاء الفيديو مهمة غير متزامنة. خزّن معرّف طلب العميل ومعرّف الفيديو المُعاد، واستعلم كل 5 ثوانٍ تقريبًا، وتوقف عندما تصل المهمة إلى created أو failed. يتم الاحتفاظ بروابط الفيديو المكتملة لمدة 7 أيام، لذا انسخ الوسائط المنتهية إلى مخزنك الدائم عند الحاجة.

أين ينبغي أن أخزّن مفتاح VisionStory API الخاص بي؟

احتفِظ بـ VISIONSTORY_API_KEY في متغير بيئة على الخادم، أو كسرّ ضمن CI، أو في مخزن أسرار عميل MCP، وأرسله عبر ترويسة طلب X-API-Key. لا تضمن المفتاح أبدًا داخل كود المتصفح، أو حزمة تطبيق جوّال، أو مستودع عام، أو لقطات شاشة، أو سجلات، أو رسالة دردشة مع ذكاء اصطناعي.

ما الذي يمكنني دمجه مع واجهة برمجة تطبيقات فيديو الأفاتار؟

يمكنك دمج فيديو الأفاتار مع تحويل النص إلى كلام، والأصوات العامة أو المستنسخة، وأصول الصور والصوت القابلة لإعادة الاستخدام، والتفريغ النصي، ومولد الصور بالذكاء الاصطناعي، ونماذج الفيديو المتقدمة. تدعم هذه اللبنات شروحات مترجمة، وتواصلًا مخصصًا، ومحتوى تعلّم مؤتمتًا، وسير عمل وسائط يقوده وكيل ذكاء اصطناعي.

VisionStory API
مصممة للمطورين

أنشئ فيديوهات أفاتار ناطق متزامنة حركة الشفاه من النص أو الصوت باستخدام VisionStory REST API أو Python SDK. اكتشف النماذج والأفاتارات والأصوات المتاحة حاليًا، وأرسل مهمة غير متزامنة، ثم نزّل ملف MP4 النهائي—أو أتمت نفس سير العمل عبر CLI أو خادم MCP أو Agent Skill.

استكشف وثائق المطورين

POST /api/v1/video

REST API
Python SDK
CLI
MCP
Agent Skill

جاهز للوكلاء

يعمل حيث يعمل وكلاؤك.

انسخ رسالة إعداد واحدة لوكيل البرمجة لديك، أو اربط خادم MCP واجعل VisionStory أداة قابلة لإعادة الاستخدام.

VisionStory CLI

ثبّت مرة واحدة. استخدم كل API من الطرفية.

يقوم المُثبّت بالترقية إلى أحدث إصدار على PyPI ضمن بيئة معزولة. تبقى مشاريع Python الحالية لديك دون أي تغيير.

curl -fsSL https://developers.visionstory.ai/cli | bash

macOS · Linux · WSLخيارات التثبيت

أرسل مطالبة الإعداد هذه إلى Claude Code

Help me set up VisionStory and generate a talking-avatar video.1. Install or update the CLI and Agent Skill:   curl -fsSL https://developers.visionstory.ai/cli | bash   npx skills add visionstory-ai/skills --skill visionstory-api2. Run visionstory doctor. If I need a key, send me to https://developers.visionstory.ai/api-keys, wait while I create one, then ask me to run visionstory login in my terminal. Never ask me to paste the key into chat or expose it.3. Verify access with visionstory credits. Stop and help me if it fails.4. Discover current models, avatars, and voices, then use the CLI and visionstory-api skill to create and download the video. Never delete anything unless I explicitly request and confirm it.

جديد هنا؟

أنشئ مفتاح API، ثم أرسل هذه المطالبة إلى وكيل البرمجة لديك. سيرشدك خلال تسجيل الدخول إلى VisionStory، والتحقق من النقاط، وإنشاء الفيديو دون كشف مفتاحك.

أدوات المطورين من VisionStory

اختر تكامل API المناسب لحزمتك التقنية.

تستخدم REST وPython SDK وCLI وخادم MCP وAgent Skill جميعها نفس VisionStory API الموثّقة ومعرّفات الموارد نفسها. ابدأ بواجهة واحدة، ثم انقل سير عمل فيديو الأفاتار نفسه إلى الواجهة الخلفية أو خط CI أو وكيل برمجة.

01REST

استدعِ REST API

استدعِ VisionStory من أي لغة للواجهة الخلفية. اعرض النماذج والأفاتارات والأصوات الحالية؛ أرسل text_script أو audio_script إلى POST /api/v1/video؛ ثم راقب المهمة حتى يتم إنشاؤها؛ وبعدها نزّل ملف MP4.

اطّلع على مرجع REST API 02PYTHON

ابنِ باستخدام Python SDK

استخدم عميل Python المعرّف الأنواع وبدون تبعيات لإجراء المصادقة عبر متغيرات البيئة، وبناء الحمولة، ورفع الملفات، ومراقبة المهام، والتنزيل. مناسب لتطبيقات Python ودفاتر الملاحظات والخدمات الإعلامية الداخلية.

اقرأ البدء السريع لـ Python SDK 03CLI

أتمتِ باستخدام CLI

شغّل visionstory doctor، وتحقق من النقاط، واكتشف معرّفات الموارد، وأنشئ فيديوهات أفاتار، وافحص المهام، ونزّل النتائج من الطرفية أو سكربت shell أو مهمة CI بدون الحاجة إلى بناء تطبيق أولًا.

ثبّت CLI وتحقق منه 04MCP / SKILL

اربط وكيل برمجة بالذكاء الاصطناعي

اربط خادم VisionStory MCP أو ثبّت Agent Skill لكي يتمكن Codex وClaude Code وCursor وWindsurf وCline وGemini من اكتشاف الموارد وإنشاء الوسائط وتنزيل النتائج، بينما يبقى مفتاح API محفوظًا في مخزن الأسرار المحلي.

اربط MCP أو Agent Skill

البدء السريع لـ API الأفاتار الناطق

أنشئ أول فيديو أفاتار ناطق لك.

أنشئ مفتاح API على جانب الخادم، وتحقق من رصيد النقاط، واكتشف معرّفات النموذج والأفاتار والصوت الحالية. أرسل text_script أو audio_script إلى POST /api/v1/video، وراقب كل حوالي 5 ثوانٍ حتى يتم إنشاء المهمة، ثم نزّل ملف MP4. يتم الاحتفاظ بروابط الفيديوهات المكتملة لمدة 7 أيام.

create_video.py

from pathlib import Pathfrom visionstory import VisionStoryClient, build_video_payload client = VisionStoryClient.from_env()payload = build_video_payload(    avatar_id="YOUR_AVATAR_ID",    text="Hello from my product.",    voice_id="YOUR_VOICE_ID",)video = client.generate_video(payload)client.download(video["video_url"], Path("result.mp4"))

كتالوج نماذج VisionStory

اختر النموذج المناسب للمخرجات التي تحتاجها.

ابدأ بالمهمة التي تريد إنجازها، ثم اجلب كتالوج النماذج الحالي وقت التشغيل. تُعد استجابة API المصدر الموثوق لمعرّفات الموارد المتاحة والمعلمات المقبولة وحدود المخرجات.

مقدّم تم إنشاؤه باستخدام نموذج الأفاتار الناطق VisionStory V-Character

أفاتار ناطقVisionStory

V-Character 4.0

vs_character_v4

يحوّل نموذج الشخصية الأصلي من VisionStory صورة بورتريه واحدة مع نص أو صوت مُسجّل إلى أداء متّسق الهوية بحركة تعبيرية وتزامن شفاه طبيعي.

نص أو صوت مُسجّل
720p أو 1080p أو 2K
حتى 10 دقائق

تسلسل سيارة سينمائي تم إنشاؤه باستخدام نموذج فيديو الذكاء الاصطناعي Seedance

فيديو الذكاء الاصطناعيByteDance

Seedance 2.5

seedance-2.5

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

تحويل النص إلى فيديو
تحويل الصورة إلى فيديو
مقاطع من 4 إلى 30 ثانية

رمانة زجاجية بتفاصيل دقيقة تم إنشاؤها باستخدام نموذج الصور Nano Banana

صور بالذكاء الاصطناعيGoogle

Nano Banana 2

nano-banana-2

أنشئ صورًا عالية الدقة، واعرض النص بشكل موثوق، وحسّن النتائج عبر تعديلات حوارية موجّهة بالمراجع.

تحويل المطالبة إلى صورة
تحرير موجّه بالمراجع
مخرجات 1K و2K

واجهات برمجة وسائط بالذكاء الاصطناعي قابلة للتركيب

ادمج بين API الأفاتار والصوت وفيديو الذكاء الاصطناعي.

استخدم مفتاح API واحدًا لإنشاء مقدّمين ناطقين، وتوليد كلام طبيعي، وإعادة استخدام أفاتارات وأصوات وأصول وسائط مخصصة، وإنشاء مقاطع فيديو داعمة. أنشئ شروحات مترجمة محليًا، وتجارب تهيئة مخصصة، ومحتوى تعليمي، وتواصلًا للمبيعات، أو وسائط ينشئها الوكيل—من دون الحاجة إلى ربط مزوّدين منفصلين.

سير العمل الأساسي للأفاتار

API فيديو الأفاتار الناطق

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

نص يتحول إلى موجة صوتية عبر VisionStory API لتحويل النص إلى كلام

طبقة الصوت والكلام

واجهة برمجة التطبيقات لتحويل النص إلى كلام والصوت

حوّل النص إلى كلام طبيعي بصيغة MP3 باستخدام صوت عام أو مستنسخ، ثم أعد استخدام الصوت نفسه عبر فيديوهات الأفاتار والمحتوى المترجم. استعلم عن كتالوج الأصوات وقت التشغيل بدلًا من ترميز معرّفات الصوت بشكل ثابت.

prompt يتحول إلى فيديو مُولّد عبر VisionStory API لفيديو الذكاء الاصطناعي

إنشاء موجّه بواسطة وكيل

واجهة برمجة التطبيقات لتوليد فيديو الذكاء الاصطناعي

أنشئ مقاطع من النص إلى فيديو، ومن الصورة إلى فيديو، ومقاطع موجّهة بالمرجع باستخدام نموذج يتم اختياره من الكتالوج المباشر. يمكن لوكيل ذكاء اصطناعي تجهيز الـ prompts والأصول، وتقدير النقاط، وإرسال المهمة، ودمج النتيجة مع مُقدّم أفاتار.

الأسئلة الشائعة حول واجهة برمجة تطبيقات فيديو الأفاتار بالذكاء الاصطناعي

إجابات مباشرة حول المصادقة، والطلبات، والمهام غير المتزامنة، وSDKs، وأتمتة CLI، وMCP، والاستخدام في بيئة الإنتاج.

واجهة برمجة تطبيقات فيديو الأفاتار بالذكاء الاصطناعي تحوّل مُقدّمًا رقميًا مع نص أو صوت مسجّل إلى فيديو متزامن مع حركة الشفاه يمكن للتطبيق توليده برمجيًا. يستقبل VisionStory طلبات مصادَقة من جهة الخادم، ويعيد معرّف الفيديو فورًا، ويعرض المهمة بشكل غير متزامن، ويوفّر رابط MP4 عند اكتمال التوليد.
أنشئ مفتاح VisionStory API، وتحقق من النقاط لديك، واجلب معرّفات النموذج والأفاتار والصوت الحالية، ثم أرسل إمّا text_script أو audio_script عبر POST /api/v1/video. تعيد الواجهة معرّف الفيديو فورًا. استعلم عن حالة المهمة كل 5 ثوانٍ تقريبًا حتى تصبح created، ثم نزّل ملف MP4 من video_url.
استخدم REST عندما تحتاج إلى تحكم مستقل عن اللغة، واستخدم Python SDK عند بناء خدمة Python أو دفتر ملاحظات، واستخدم CLI لأتمتة الطرفية وCI أو التوليد على دفعات. تستخدم الواجهات الثلاث الموارد نفسها في VisionStory وسير عمل الفيديو غير المتزامن.
نعم. ثبّت VisionStory Agent Skill أو صِل بخادم VisionStory MCP. يمكن لوكيل برمجة مدعوم التحقق من النقاط، وعرض النماذج والأفاتارات والأصوات الحالية، وتجهيز طلب صالح، وبدء مهمة الفيديو، ومراقبتها، وتنزيل النتيجة مع بقاء مفتاح API في بيئتك أو في مخزن أسرار MCP.
نعم. أرسل audio_script عندما تريد أن يتحدث الأفاتار من صوت مسجّل، أو أرسل text_script مع معرّف صوت عندما يجب على VisionStory توليد الكلام. استخدم نوعًا واحدًا من النصوص لكل طلب بدلًا من إرسال الاثنين معًا.
اعتبر إنشاء الفيديو مهمة غير متزامنة. خزّن معرّف طلب العميل ومعرّف الفيديو المُعاد، واستعلم كل 5 ثوانٍ تقريبًا، وتوقف عندما تصل المهمة إلى created أو failed. يتم الاحتفاظ بروابط الفيديو المكتملة لمدة 7 أيام، لذا انسخ الوسائط المنتهية إلى مخزنك الدائم عند الحاجة.
احتفِظ بـ VISIONSTORY_API_KEY في متغير بيئة على الخادم، أو كسرّ ضمن CI، أو في مخزن أسرار عميل MCP، وأرسله عبر ترويسة طلب X-API-Key. لا تضمن المفتاح أبدًا داخل كود المتصفح، أو حزمة تطبيق جوّال، أو مستودع عام، أو لقطات شاشة، أو سجلات، أو رسالة دردشة مع ذكاء اصطناعي.
يمكنك دمج فيديو الأفاتار مع تحويل النص إلى كلام، والأصوات العامة أو المستنسخة، وأصول الصور والصوت القابلة لإعادة الاستخدام، والتفريغ النصي، ومولد الصور بالذكاء الاصطناعي، ونماذج الفيديو المتقدمة. تدعم هذه اللبنات شروحات مترجمة، وتواصلًا مخصصًا، ومحتوى تعلّم مؤتمتًا، وسير عمل وسائط يقوده وكيل ذكاء اصطناعي.

ابدأ بطلب مصادَق واحد

ابنِ أول تكامل لفيديو أفاتار بالذكاء الاصطناعي.

أنشئ مفتاح API، وتحقق من النقاط لديك، وشغّل دليل البدء السريع للأفاتار الناطق من 5 خطوات. ابدأ بـ REST أو Python، ثم أضف أتمتة CLI أو أدوات MCP أو Agent Skill مع نمو سير عملك. استعلم عن نقاط نهاية الموارد المباشرة بدلًا من ترميز معرّفات النموذج أو الأفاتار أو الصوت بشكل ثابت.

أنشئ مفتاح VisionStory API استكشف وثائق المطورين