كيفية إنشاء مولد فيديو بالذكاء الاصطناعي باستخدام Bolt وCometAPI: دليل خطوة بخطوة

الخلاصة

يمكن لـ Bolt إنشاء واجهة التطبيق، بينما يوفر CometAPI واجهة برمجة تطبيقات لتوليد الفيديو. احتفظ بمفتاح CometAPI على الخادم، قدّم مهام Vidu عبر POST /v1/videos، واستعلم عن معرّف المهمة المرجع، ثم وفّر الفيديو المكتمل عبر مسارات معاينة وتنزيل موثّقة. ستحتاج إلى مشروع Bolt، وحساب CometAPI ممول مع صلاحية الوصول إلى النموذج المختار، وبيئة لتشغيل دوال الخادم؛ تشرح الأمثلة أدناه جوهر التكامل، بينما يجب تنفيذ المصادقة والحصص وفحوصات ملكية المهام وسجلات المهام الدائمة قبل الإطلاق.

أهم النقاط المستفادة

• ينشئ Bolt واجهة استوديو فيديو متجاوبة من مواصفات تطبيق بلغة طبيعية.

• يوفّر CometAPI الاستدلال الخاص بالفيديو عبر نماذج التوليد المدعومة، باستخدام مفتاح API محمي على الخادم.

• ابدأ بالنص إلى فيديو؛ ثم وسّع إلى الصورة إلى فيديو بعد التأكد من دورة حياة المهمة.

• جاهزية الإنتاج تتطلب مصادقة، حصص، فحوصات ملكية المهام، إعادة محاولات، وتخزينًا متينًا للمخرجات.

• قِس القيمة الحقيقية بمعدّل الإكمال، والزمنية، وتكلفة المقاطع المقبولة، والالتزام بالموجه.

ما الغرض من Bolt وCometAPI في توليد فيديو الذكاء الاصطناعي؟

يبني Bolt الواجهة ومنطق التطبيق وتدفق النشر. يوفّر Bolt Cloud خدمات المشروع مثل قاعدة البيانات والاستضافة والمصادقة والتخزين ودوال الخادم. يوفّر CometAPI الوصول إلى واجهات API للنماذج، بما في ذلك نماذج الفيديو المدعومة ونقاط نهاية الاستدلال. ضع الاستدلال المدفوع خلف دوال خادم موثّقة، مع سجلات مهام دائمة، وفحوصات ملكية، وضوابط الفوترة.

هل CometAPI متوافق مع OpenAI؟

يوفّر CometAPI واجهات متوافقة مع OpenAI للنماذج النصية ونماذج الدردشة المدعومة. اضبط نقطة النهاية والنموذج وفقًا لمجموعة SDK والمسار المستخدم؛ فالتوافق لا يعني أن كل نموذج يقبل نفس مُخطط الطلب.

واجهة Vidu للفيديو منفصلة عن واجهة الدردشة المتوافقة مع OpenAI. إنشاء الفيديو يستخدم POST /v1/videos مع multipart/form-data، لذا يجب أن يستدعي التطبيق نقطة نهاية الفيديو مباشرة من دالة خادم محمية.

كيف تعمل واجهة CometAPI Vidu للفيديو؟

إنشاء مهمة فيديو

أنشئ مهمة عبر POST /v1/videos باستخدام multipart/form-data. يستخدم هذا الدليل viduq3؛ كما أن viduq3-turbo خيار موثق آخر. أكّد صلاحية الوصول إلى النموذج لمفتاح API لديك واحتفظ بمعرّف المهمة المرجع المُعاد. راجع مرجع واجهة الإنشاء.

معاملات POST /v1/videos

يحتوي الجدول أدناه على مدخلات الإنشاء. أرسل الحقول القياسية كسلاسل نصية. بالنسبة إلى seconds، استخدم سلسلة بقيمة صحيحة من "1" حتى "16"؛ يمكن للتطبيق التحقق من مدة رقمية قبل التسلسل. حد 2000 حرف للموجه في هذا الدليل هو سياسة تطبيق.

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

• فئة 540p: استخدم قيمة API للحجم 960x528 للتجارب.
• فئة 720p: استخدم 1280x720 لمعاينات الويب.
• فئة 1080p: استخدم 1920x1080 لتسليم أعلى جودة.

يجب أن يرفض التحقق على الخادم التركيبات غير المدعومة ويمنع المستخدمين من طلب توليد مدفوع غير محدود.

الاستعلام عن حالة المهمة

تحقق من GET /v1/videos/{task_id} من الواجهة الخلفية بعد التحقق من ملكية المهمة. استمر حتى تصل المهمة إلى حالة نهائية؛ واحتفظ بمعرّف المهمة حتى يتمكن تحديث الصفحة أو انتهاء مهلة المتصفح من استئناف نفس المهمة.

تنزيل الفيديو المكتمل

بعد الإكمال، اطلب GET /v1/videos/{task_id}/content عبر الواجهة الخلفية، وبثّ النتيجة أو خزّنها في تخزين مضبوط. يوضّح سير العمل التالي كيفية ربط هذه العمليات مع Bolt.

كيفية بناء مولد فيديو بالذكاء الاصطناعي باستخدام Bolt + CometAPI

الخطوة 1: إنشاء المشروع في Bolt

افتح Bolt واطلب منه إنشاء مشروع React + TypeScript. ألصق هذه المواصفات في مربع المطالبة، ثم راجع الواجهة المُنشأة قبل ربط التوليد المدفوع:

Build a responsive AI Video Studio using React, TypeScript, and Tailwind CSS.
Use a dark-themed layout with prompt editing, example prompts, 5/10/15-second
choices, 540p/720p/1080p options, Generate Video button, job status,
video preview and download, and a recent-generations section.
Use Bolt Cloud authentication, database, and server functions.
Require sign-in before video creation. Store COMETAPI_KEY only in server secrets.
Create authenticated generate-video and video-status server endpoints.
Connect to real CometAPI tasks; poll status every 10 seconds.
Do not use mock videos in the production path.

الخطوة 2: تهيئة مفتاح CometAPI

أنشئ مفتاح API في CometAPI، ثم أضِف سرًا خلفيًا باسم COMETAPI_KEY. لا تقم أبدًا بتخزينه في ملفات واجهة أمامية، أو تعريضه لكود المتصفح، أو استخدام متغير بيئة يبدأ بـ VITE_.

في إعدادات مشروع Bolt، أضِف COMETAPI_KEY عبر واجهة إدارة الأسرار على جانب الخادم للمشروع. لا تضعه في كود الواجهة الأمامية ولا تعرّضه لجافاسكريبت المتصفح. اعتبر السطر التالي مثالًا على التسمية، وليس ملف .env للواجهة الأمامية.

COMETAPI_KEY=your_actual_cometapi_api_key

الخطوة 3: تقديم مهمة توليد فيديو

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

يستخدم هذا المثال تخطيط دالة حافة Deno بأسلوب Supabase. اطلب من Bolt وضعه في وقت تشغيل الخادم المُهيّأ فعليًا لمشروعك. تعليقات المصادقة والاستمرارية هي نقاط تكامل، وليست وسائل حماية مُنفّذة: لا تنشر هذا الهيكل بوصفه نقطة نهاية مدفوعة عامة.

// supabase/functions/generate-video/index.ts
import { serve } from "https://deno.land/std/http/server.ts";
serve(async (req: Request) => {
  if (req.method !== "POST") return Response.json({error:"Method not allowed"},{status:405});
  try {
    // Verify the signed-in user and enforce quotas here.
    const {prompt, seconds, size} = await req.json();
    const sizes = ["960x528", "1280x720", "1920x1080"];
    if (typeof prompt !== "string" || !prompt.trim() || prompt.length > 2000 ||
        !Number.isInteger(seconds) || seconds < 1 || seconds > 16 ||
        !sizes.includes(size)) {
      return Response.json({error:"Invalid options"},{status:400});
    }
    const key = Deno.env.get("COMETAPI_KEY");
    if (!key) throw new Error("Missing API key");
    const form = new FormData();
    form.append("model", "viduq3");
    form.append("prompt", prompt.trim());
    form.append("seconds", String(seconds));
    form.append("size", size);
    const response = await fetch("https://api.cometapi.com/v1/videos", {
      method: "POST", headers: {Authorization: `Bearer ${key}`}, body: form,
      signal: AbortSignal.timeout(60000)
    });
    if (!response.ok) throw new Error(`Provider status ${response.status}`);
    const result = await response.json();
    const taskId = result.id ?? result.task_id;
    if (!taskId) throw new Error("Task ID missing");
    // Persist taskId and owner ID in application database here.
    return Response.json({taskId, status: result.status ?? "queued"});
  } catch (e) {
    console.error(e);
    return Response.json({error:"Unable to create video"},{status:500});
  }
});

الخطوة 4: استرجاع حالة التوليد

تعيد عملية التقديم مُعرّف مهمة غير متزامن. تحقق من GET /v1/videos/{task_id} عبر نقطة نهاية خادم بعد التحقق من أن المستخدم الطالب يملك المهمة.

// Server-only helper
async function getVideoStatus(taskId: string) {
  const key = Deno.env.get("COMETAPI_KEY");
  if (!key) throw new Error("Missing API key");
  const response = await fetch(
    `https://api.cometapi.com/v1/videos/${encodeURIComponent(taskId)}`,
    {headers: {Authorization: `Bearer ${key}`}, signal: AbortSignal.timeout(60000)}
  );
  if (!response.ok) throw new Error(`Status ${response.status}`);
  const task = await response.json();
  return {taskId, status: task.status, progress: task.progress ?? null};
}

تبدأ المهمة في queued، وقد تنتقل إلى in_progress، وتنتهي في completed، أو failed، أو error. فعّل المعاينة والتنزيل فقط بعد completed؛ اعرض خطأً واسمح بطلب جديد لحالات الفشل النهائية.

الخطوة 5: ربط واجهة Bolt الأمامية

type VideoTask = {taskId: string; status: string; progress?: number | null};
async function startVideo(prompt: string, seconds: number, size: string): Promise<VideoTask> {
  const res = await fetch("/api/generate-video", {
    method: "POST", headers: {"Content-Type":"application/json"},
    body: JSON.stringify({prompt, seconds, size})
  });
  if (!res.ok) throw new Error("Generation request failed");
  return res.json();
}
async function checkVideo(taskId: string): Promise<VideoTask> {
  const res = await fetch(`/api/video-status?id=${encodeURIComponent(taskId)}`);
  if (!res.ok) throw new Error("Status request failed");
  return res.json();
}
async function waitForVideo(taskId: string, onUpdate: (task: VideoTask) => void) {
  const deadline = Date.now() + 20 * 60 * 1000;
  while (Date.now() < deadline) {
    const task = await checkVideo(taskId);
    onUpdate(task);
    if (task.status === "completed") return task;
    if (["failed", "error"].includes(task.status)) throw new Error("Render failed");
    await new Promise(resolve => setTimeout(resolve, 10000));
  }
  throw new Error("Polling paused; resume this task ID before submitting again");
}

مسارات /api/ هي مسارات تطبيق يجب عليك تهيئتها. بالنسبة لدوال خادم Bolt Cloud، استخدم عميل الواجهة الخلفية المُولّد وعناوين نقاط النهاية الموثّقة. أوقف الاستعلام المستمر عند إلغاء تركيب المكوّن، واستخدم تراجعًا محدودًا لردود 429/5xx. إن انتهاء مهلة الاستعلام في المتصفح لا يثبت فشل المزوّد: احتفظ بمعرّف المهمة واستأنف فحوصات الحالة قبل إنشاء مهمة مدفوعة أخرى.

الخطوة 6: معاينة النتيجة وتنزيلها

عند اكتمال المهمة، تسترجع الواجهة الخلفية GET /v1/videos/{task_id}/content. قم ببث البيانات إلى مالك المهمة الموثّق أو احفظها في تخزين كائنات مضبوط ووفّر عنوان URL مفوضًا. لا تكشف أبدًا عن مفتاح حامل CometAPI في المتصفح.

يجب أن يوفّر تطبيقك مسار محتوى مملوكًا للمستخدم أو عنوان URL تخزين مفوض لمكوّن المعاينة. يكون عنوان URL موقّع قابلاً للوصول لأي شخص يحمله حتى انتهاء صلاحيته؛ اجعل فترة صلاحيته قصيرة. للحصول على تنزيلات موثوقة، استخدم مسارًا من نفس الأصل مع ترويسة Content-Disposition المناسبة، إذ قد تتجاهل المتصفحات خاصية التنزيل لروابط من أصل مختلف.

type VideoPreviewProps = {videoUrl: string};
export function VideoPreview({videoUrl}: VideoPreviewProps) {
  return <div className="rounded-xl p-4">
    <video controls playsInline className="w-full rounded-lg" src={videoUrl}/>
    <a href={videoUrl} download="ai-generated-video.mp4">Download Video</a>
  </div>;
}

الخطوة 7: الاختبار والنشر

اختبر أولًا طلبًا مدته خمس ثوانٍ عند 540p: “A cinematic close-up of a silver smartwatch on a dark desk. The camera slowly moves left to right. Soft morning light reflects from the metal.” تحقق من أن طلبًا واحدًا يُنشئ مهمة واحدة، وأن الحالة تتقدّم، وأن النتيجة تعمل، وأن التنزيل ينجح. اختبر الموجهات غير الصالحة، الجلسات المنتهية، الحد من المعدل، ملكية المهام، وفشل المزوّد قبل النشر.

فحص الاكتمال: سجّل الدخول كمستخدم ثانٍ وتأكد من أن مهمة المستخدم الأول لا يمكن قراءتها أو تنزيلها؛ حدّث الصفحة أثناء المعالجة وتأكد من أن المهمة المحفوظة يمكن استعادتها؛ افحص طلبات المتصفح والأصول المبنية للتأكد من عدم تسريب المفتاح عن طريق الخطأ. انشر فقط بعد اجتياز هذه الاختبارات الثلاثة بالإضافة إلى التشغيل والتنزيل.

كيف تضيف توليد صورة إلى فيديو؟

لخيار الصورة إلى فيديو، أضِف ملف صورة واحدًا مُتحققًا منه بوصفه input_reference في جسم multipart. يذكر المسار الحالي حدًا أقصى 20 ميجابايت لكل صورة؛ طبّق حدًا أصغر على مستوى التطبيق إذا لزم الأمر، وتحقق من نوع المحتوى ومحتويات الملف الفعلية على الخادم. مرّر الصورة عبر الواجهة الخلفية الموثّقة؛ لا ترسل مفتاح CometAPI مع رفع المتصفح.

const form = new FormData();
form.append("model", "viduq3");
form.append("prompt", prompt);
form.append("seconds", "5");
form.append("size", "1280x720");
form.append("input_reference", imageFile);
const response = await fetch("https://api.cometapi.com/v1/videos", {
  method: "POST", headers: {Authorization: `Bearer ${apiKey}`}, body: form
});
if (!response.ok) throw new Error(`API ${response.status}`);
const result = await response.json();
console.log(result.id ?? result.task_id);

بالنسبة لمدخلات الصور، صف الحركة والكاميرا المطلوبة بدلًا من مجرد تكرار المشهد: “The character turns toward the window. Curtains move gently in the breeze. Preserve face, clothing, and lighting. Use a subtle forward camera motion.”

Vidu Q3 مقابل نماذج الفيديو الأخرى: ما الذي يجب قياسه؟

قارن النماذج على نفس الموجهات والمدة والدقة ومعايير القبول. يعرّف هذا القسم طريقة مقارنة؛ ولا يدّعي فائزًا مُختبرًا. سجّل نسخة النموذج، والمسار، وتاريخ الاختبار، وعدد العينات لأي نتائج منشورة.

• معدّل الإكمال: اقسم الوظائف الناجحة على الوظائف المقدّمة لقياس الاعتمادية.
• الزمنية: تتبّع أزمنة المعالجة P50 وP95 لفهم التجربة النموذجية والطلبات الأبطأ.
• الالتزام بالموجه: استخدم مراجعة بشرية أو تقييمًا موحّدًا لتقدير مدى اتباع المخرجات للتعليمات المطلوبة.
• الاتساق الزمني: افحص الاستمرارية بين الإطارات لتقييم الاستقرار البصري.
• تزامن الصوت: راجع التوقيت والوضوح لتقييم الحوار والصوت.
• التكلفة لكل مقطع مقبول: اقسم إجمالي الإنفاق على المخرجات المعتمدة لفهم اقتصاديات التشغيل.

ما تكلفة واجهة CometAPI لتوليد الفيديو؟

يوفّر الجدول أدناه تسعيرًا مرجعيًا لواجهات Vidu Q3 وVidu Q3 Turbo في CometAPI. قد تختلف التكاليف حسب النموذج والدقة وإعدادات التوليد. تحقق من أحدث الأسعار وتوفر النماذج في حساب CometAPI الخاص بك قبل تقدير ميزانية توليد الفيديو.

تبدأ تكلفة Vidu Q3 Turbo API في CometAPI من $0.028 لكل ثانية. قد يختلف التسعير حسب الدقة، ووضع التوليد، وإصدار النموذج. تحقق من الأسعار الحالية في حساب CometAPI الخاص بك قبل توليد الفيديو.

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

استنادًا إلى الأسعار المرجعية، تبلغ تكلفة فيديو مدته خمس ثوانٍ بدقة 720p نحو $0.616 مع Vidu Q3 أو $0.308 مع Vidu Q3 Turbo. عند 540p، التقديرات المقابلة هي $0.280 و$0.140. هذه الأرقام حسابات توضيحية وليست رسومًا مضمونة. للحصول على ميزانية دقيقة، قارن التكاليف التقديرية مع استخدام API الفعلي وسجلات الفوترة.

كيف تنقل مولّد فيديو قائمًا إلى Bolt + CometAPI؟

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

الأسئلة الشائعة

كيف أجعل أسلوبًا بصريًا معتمدًا قابلاً للتكرار عبر سلسلة؟

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

كيف يحافظ سرد متعدد اللقطات على الاتساق عندما يكون كل توليد مقطعًا قصيرًا؟

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

ماذا يجب أن يحدث إذا انتهت مهلة المتصفح بعد تقديم مدفوع؟

عامله بوصفه نتيجة غير مؤكدة حتى تتم تسوية مهمة المزوّد المحفوظة. احتفظ بمعرّف طلب محلي للتطبيق ومعرّف مهمة المزوّد، ودَع المستخدم يعيد فتح تلك المهمة واستأنف فحوصات الحالة. إذا انتهت مهلة التقديم نفسه قبل إعادة معرّف، افحص سجلات الطلب المتاحة وسجلات الاستخدام قبل عرض محاولة أخرى. لا تعد بأن انتهاء مهلة HTTP يعني عدم حدوث خصم. اجعل أي محاولة مدفوعة جديدة صريحة، واستخدم قفل طلب على مستوى التطبيق لمنع ضغط مزدوج.

ماذا أراجع قبل قبول صور مرجع خاصة بعملاء؟

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

كيف أحافظ على قابلية نقل المشروع إذا تغيّر الbackend أو مزوّد الفيديو؟

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

الخاتمة

يشكل Bolt + CometAPI أساسًا عمليًا لتطبيق توليد فيديو: يسرّع Bolt إنشاء تطبيقات الويب، ويوفّر CometAPI الوصول إلى نماذج الفيديو المدعومة. ابدأ بتدفق آمن من نص إلى فيديو، وأثبت أن دورة حياة المهمة وضوابط الفوترة تعملان، ثم أضِف مراجع صور، وسجلًا للتوليد، واختيار النموذج، وأدوات إبداعية متقدمة. إن فصل تفاعلات الواجهة الأمامية عن الاستدلال المدفوع على الخادم أمر أساسي لمنتج آمن وموثوق.