كيفية استخدام واجهة برمجة تطبيقات Wan 2.7: دليل المطورين الكامل

الإجابة السريعة

Wan 2.7 هي حزمة توليد فيديو متعددة الوسائط من Alibaba لدفقات العمل النص إلى فيديو، الصورة إلى فيديو، التوليد الموجّه بالمرجع والتحرير. من خلال Wan 2.7 على CometAPI، يستخدم المطورون معرّف النموذج wan2.7 مع نقطة النهاية غير المتزامنة POST /v1/videos. يمر التكامل بثلاث مراحل تشغيلية: إرسال مهمة، استطلاع معرّف الفيديو المُعاد، ثم تنزيل ملف MP4 المكتمل. يدعم المسار الحي مخرجات 720p و1080p ويعرض التسعير لكل ثانية، لذا تحدد المدة والدقة التكلفة التقديرية للتوليد. ابدأ بطلب نص إلى فيديو مدته 5 ثوانٍ بدقة 720p، تحقّق من صحة سير العمل، ثم أضف مراجع الصور أو ارفع الدقة فقط بعد نجاح المسار الأساسي.

النطاق المهم: يغطي هذا الدليل Wan 2.7 Video عبر CometAPI. لا يصف نموذج توليد الصور Wan المنفصل، لذا فإن مواصفات الصور فقط مثل مخرجات الصور الثابتة بدقة 4K لا تُعد قدرات لـ Wan 2.7 Video.

أهم النقاط

• يوفّر CometAPI وصولاً إلى Wan 2.7 عبر نقطة نهاية فيديو غير متزامنة على نمط OpenAI بدلًا من استجابة محادثة متزامنة.
• يستخدم المسار معرّف النموذج wan2.7 والطريق POST /v1/videos.
• يجب أن يحافظ التكامل الكامل على معرّف الفيديو المُعاد، ويستطلع نقطة نهاية الحالة، ويتعامل مع الإخفاقات النهائية، وينزّل ملف MP4 فقط بعد النجاح.
• تدعم واجهة Alibaba الأصلية للنص إلى فيديو في Wan 2.7 720P و1080P مع مدة 2-15 ثانية؛ يستخدم مسار CometAPI أسماء حقول موحّدة خاصة به.
• تتوفر تدفقات عمل الصورة إلى فيديو، والإطار الأول/الأخير والاستكمال ضمن عائلة نموذج Alibaba الأصلية، لكن يجب التحقق من الحقول المتقدمة المتاحة عبر المسار الموحّد مقابل وثائق المسار الحي.
• أقوى الأدلة المعيارية العامة تخص الفيديو إلى فيديو: تصدّر Wan 2.7 فئة Design Arena. لا ينبغي تعميم تلك النتيجة على كل مهام النص إلى فيديو أو الصورة إلى فيديو.
• المقياس الإنتاجي الأكثر فائدة هو التكلفة لكل مقطع مقبول، وليس سعر الثانية المولّدة فقط.

ما هو Wan 2.7؟

Wan 2.7 بلغة المطورين المبسطة

Wan 2.7 ليس مجرد نقطة تفتيش من المطالبة إلى الفيديو. تصف Alibaba عائلة فيديو من أربعة أجزاء تمتد عبر Wan2.7-t2v, Wan2.7-i2v, Wan2.7-r2v و Wan2.7-videoedit. تغطي هذه المتغيرات مجتمعة التوليد من النص، وتحريك الصور، والتحكم الموجّه بالمرجع في الموضوع أو الأسلوب، وتحويل الفيديو الموجود. هذا مهم لتصميم التطبيقات: قد يستخدم مقطع تسويقي بسيط النص إلى فيديو فقط، بينما قد يحتاج خط إنتاج يحافظ على اتساق الشخصية إلى مدخلات مرجعية، وإطارات مثبتة، وإرشاد صوتي وتحرير تكراري.

على CometAPI، يقوم المسار عمدًا بضغط التسمية الخاصة بالمزوّد ضمن معرّف نموذج العميل wan2.7. تبقى قدرة التوليد الأساسية هي Wan 2.7، لكن المصادقة ومسارات نقاط النهاية وأسماء المعلمات تختلف عن واجهة Alibaba Cloud الأصلية.

المواصفات التقنية لـ Wan 2.7

حدود المواصفات: تصف بعض صفحات الكتالوج بنية أو عدد معلمات، لكن وثائق واجهة برمجة التطبيقات الرسمية للفيديو من Alibaba لا تنشر مواصفات بنية كاملة لكل متغير من Wan 2.7. الصياغة التحريرية الأكثر أمانًا هي أن عدد المعلمات الكامل والبنية غير مُفصح عنهما بشكل شامل.

ماذا يمكن لـ Wan 2.7 أن يفعل؟

نص إلى فيديو مع مطالبات متعددة اللقطات مُوقّتة.

يمكن لـ Wan 2.7 تفسير تغييرات اللقطة المكتوبة مباشرة في المطالبة. يمكن للمطور وصف اللقطة 1 واللقطة 2 واللقطة 3 مع نطاقات زمنية بدلًا من الاعتماد على حقل تحكم منفصل باللقطات. يجعل ذلك المطالبة نفسها بمثابة لوحة قصصية مضغوطة.

التحكم في الإطار الأول والأخير.

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

استكمال الفيديو.

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

التوليد الموجّه بالصوت.

توثق Alibaba الصوت كمصدر دافع للسلوك الزمني وتزامن حركة الشفاه. بدون أصل صوتي مُحمَّل، يمكن للنموذج توليد موسيقى خلفية أو مؤثرات صوتية متطابقة. يتم اقتطاع الصوت الأطول من الفيديو المطلوب؛ يترك الصوت الأقصر بقية الفيديو صامتًا.

تمديد المطالبة، المطالبة السلبية، والعلامات المائية.

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

ماذا تقول المقاييس العامة عن Wan 2.7؟

لا تمتلك نماذج الفيديو معيارًا مقبولًا عالميًا مكافئًا لدرجات MMLU أو SWE-bench لنماذج اللغة. بالنسبة إلى Wan 2.7، الإشارة الخارجية الأوضح المنشورة هي أنه تصدّر فئة Design Arena للفيديو إلى فيديو. تُظهر صورة الترتيب في المنشور الرسمي Wan 2.7 عند تصنيف Elo قدره 1335 في تلك اللقطة. يدعم ذلك ادعاء التفضيل في التحويل والتحرير؛ لكنه لا يثبت الزعامة الشاملة في النص إلى فيديو أو الصورة إلى فيديو أو جودة الصوت أو زمن الاستجابة.

خلاصة القياس المرجعي

• استخدم نتيجة Design Arena كدليل على التنافسية في الفيديو إلى فيديو، لا كادعاء شامل عبر كل الأوضاع.
• لا تعاود استخدام أرقام قياس Wan 2.1 على أنها نتائج Wan 2.7.
• لاختيار الإنتاج، اختبر نفس المطالبات والأصول، والدقة، والمدة، والظروف الصوتية عبر النماذج.
• تتبع معدل القبول البشري، واستقرار الحركة، والحفاظ على الهوية، وزمن الاستجابة، ومعدل الإخفاق، والتكلفة لكل مقطع مقبول.

لماذا استخدام Wan 2.7 عبر CometAPI؟

واجهة فيديو موحّدة

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

POST /v1/videos GET  /v1/videos/{video_id} GET  /v1/videos/{video_id}/content

مسار إنشاء-استطلاع-تنزيل في CometAPI لدورة حياة توليد الفيديو غير المتزامنة. مصدر نقطة النهاية: CometAPI API documentation**.

• مفتاح API واحد لعدة نماذج فيديو مدعومة.
• نمط متسق لإنشاء المهام، واسترداد الحالة، وتنزيل الملف.
• رؤية مركزية للاستخدام والفوترة.
• كود تطبيق أقل مرتبط بمصادقة مزوّد واحد ومخطط الاستجابة الخاص به.
• اختبارات A/B أسرع لأن اختيار النموذج يمكن أن يتغير دون استبدال دورة حياة المهمة كاملة.

ملاحظة توافق ضرورية

توافق المسار: لا يعرِض المخطط الموحّد لـ CometAPI على /v1/videos بالضرورة كل حقل في واجهات T2V وI2V وR2V وتحرير الفيديو الأصلية لدى Alibaba Cloud. يُعد النص إلى فيديو والصورة إلى فيديو نقطتي البداية الأكثر أمانًا. قبل شحن التحكم في الإطار الأول/الأخير، المدخلات متعددة المراجع، التوجيه بالصوت أو التحرير، تحقّق من الحقول وحدود الوسائط الدقيقة في المسار الحي.

ما الذي تحتاجه قبل البدء

إنشاء حساب CometAPI ومفتاح API

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

export COMETAPI_KEY="your_api_key"$env:COMETAPI_KEY="your_api_key"

معرفة معرّف النموذج ونقاط النهاية

Model ID: wan2.7 Create endpoint: POST https://api.cometapi.com/v1/videos Status endpoint: GET https://api.cometapi.com/v1/videos/{video_id} Download endpoint: GET https://api.cometapi.com/v1/videos/{video_id}/content

تثبيت حزمة Python

python -m pip install --upgrade requests

تستخدم الأمثلة طلبات HTTP الخام لأن بيانات النموذج متعدد الأجزاء، واستطلاع الحالة، والتنزيلات الثنائية أسهل فهمًا دون طبقة SDK إضافية.

كيفية استخدام واجهة Wan 2.7 API مع CometAPI

الخطوة 1: إنشاء مهمة نص إلى فيديو

أرسل طلبًا متعدد الأجزاء يتضمن النموذج، والمطالبة، والمدة والحجم. هذا المثال لمدة 5 ثوانٍ بدقة 720p هو أقل مخاطرة للتحقّق من بيانات الاعتماد والتوجيه وإنشاء المهمة.

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=wan2.7" \  -F "prompt=A cinematic tracking shot of a futuristic train crossing a snowy mountain valley at sunrise, smooth camera motion, realistic light." \  -F "seconds=5" \  -F "size=1280x720"The response should include a task identifier under id or task_id. Log the full response during integration because providers and route versions may wrap status data differently.{  "id": "video_task_id",  "status": "queued",  "progress": 0 }

الخطوة 2: استطلاع حالة الفيديو

استخدم المعرّف المُعاد في نقطة نهاية الحالة. الاستطلاع كل 10-15 ثانية مناسب عمومًا أكثر من الحلقات الضيقة لمهمة فيديو كثيفة الحوسبة.

curl https://api.cometapi.com/v1/videos/{video_id} \  -H "Authorization: Bearer $COMETAPI_KEY"{  "id": "video_task_id",  "status": "in_progress",  "progress": 45 }

ينبغي لتطبيقك اعتبار completed أو success حالات نهائية ناجحة وfailed أو error أو FAILURE حالات نهائية فاشلة. احتفظ بالحِمل الكامل للإخفاق للتشخيص.

الخطوة 3: تنزيل ملف MP4 المكتمل

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

curl https://api.cometapi.com/v1/videos/{video_id}/content \  -H "Authorization: Bearer $COMETAPI_KEY" \  --output wan2_7_output.mp4

الخطوة 4: توليد فيديو من صورة

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

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=wan2.7" \  -F "prompt=The camera slowly pushes forward while the subject turns toward the warm window light; preserve identity, clothing and background composition." \  -F "input_reference=@reference.png" \  -F "seconds=5" \  -F "size=1280x720"

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

الخطوة 5: بناء سير عمل Python كامل

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

import os import time from pathlib import Path​ import requests​ API_KEY = os.environ.get("COMETAPI_KEY") BASE_URL = "https://api.cometapi.com/v1" POLL_INTERVAL = 12 MAX_WAIT_SECONDS = 900​ if not API_KEY:    raise RuntimeError("Set COMETAPI_KEY before running this script.")​ headers = {"Authorization": f"Bearer {API_KEY}"}​ def parse_task_data(payload):    return payload.get("data") or payload​ # 1. Submit the generation task. submit = requests.post(    f"{BASE_URL}/videos",    headers=headers,    files={        "model": (None, "wan2.7"),        "prompt": (            None,            "A cinematic tracking shot of a futuristic train "            "crossing a snowy mountain valley at sunrise."        ),        "seconds": (None, "5"),        "size": (None, "1280x720"),    },    timeout=60, ) submit.raise_for_status() submit_payload = submit.json() video_id = submit_payload.get("id") or submit_payload.get("task_id")​ if not video_id:    raise RuntimeError(f"No video ID in response: {submit_payload}")​ print(f"Created video task: {video_id}")​ # 2. Poll until a terminal state or timeout. deadline = time.monotonic() + MAX_WAIT_SECONDS while time.monotonic() < deadline:    response = requests.get(        f"{BASE_URL}/videos/{video_id}",        headers=headers,        timeout=30,    )    response.raise_for_status()    payload = response.json()    data = parse_task_data(payload)    status = str(data.get("status", "unknown"))    progress = data.get("progress", "unknown")    print(f"status={status}, progress={progress}")​    if status in {"completed", "success"} or progress in {100, "100", "100%"}:        break    if status in {"failed", "error", "FAILURE"}:        raise RuntimeError(f"Video generation failed: {payload}")​    time.sleep(POLL_INTERVAL) else:    raise TimeoutError(f"Task {video_id} exceeded {MAX_WAIT_SECONDS}s")​ # 3. Download the completed MP4. video = requests.get(    f"{BASE_URL}/videos/{video_id}/content",    headers=headers,    timeout=180, ) video.raise_for_status()​ output = Path("output") / f"{video_id}.mp4" output.parent.mkdir(parents=True, exist_ok=True) output.write_bytes(video.content)​ if output.stat().st_size == 0:    raise RuntimeError("Downloaded file is empty.")​ print(f"Saved {output} ({output.stat().st_size} bytes)")

الخطوة 6: استدعاء Wan 2.7 باستخدام JavaScript

يستخدم مثال Node.js fetch وFormData المدمجين. استخدم Node.js 18 أو أحدث؛ يكتب المثال النتيجة باستخدام node:fs/promises.

import { mkdir, writeFile } from "node:fs/promises";​ const apiKey = process.env.COMETAPI_KEY; const baseUrl = "https://api.cometapi.com/v1"; const pollIntervalMs = 12_000; const maxWaitMs = 15 * 60 * 1000;​ if (!apiKey) throw new Error("Set COMETAPI_KEY first.");​ const headers = { Authorization: `Bearer ${apiKey}` }; const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));​ const form = new FormData(); form.append("model", "wan2.7"); form.append(  "prompt",  "A cinematic tracking shot of a futuristic train crossing " +    "a snowy mountain valley at sunrise." ); form.append("seconds", "5"); form.append("size", "1280x720");​ const submitResponse = await fetch(`${baseUrl}/videos`, {  method: "POST",  headers,  body: form, }); if (!submitResponse.ok) throw new Error(await submitResponse.text());​ const submitPayload = await submitResponse.json(); const videoId = submitPayload.id || submitPayload.task_id; if (!videoId) throw new Error(`No video ID: ${JSON.stringify(submitPayload)}`);​ const deadline = Date.now() + maxWaitMs; while (Date.now() < deadline) {  const statusResponse = await fetch(`${baseUrl}/videos/${videoId}`, { headers });  if (!statusResponse.ok) throw new Error(await statusResponse.text());​  const payload = await statusResponse.json();  const data = payload.data || payload;  const status = String(data.status || "unknown");  const progress = data.progress ?? "unknown";  console.log({ status, progress });​  if (["completed", "success"].includes(status) || [100, "100", "100%"].includes(progress)) {    break;  }  if (["failed", "error", "FAILURE"].includes(status)) {    throw new Error(`Generation failed: ${JSON.stringify(payload)}`);  }  await sleep(pollIntervalMs); }​ if (Date.now() >= deadline) throw new Error(`Task ${videoId} timed out.`);​ const videoResponse = await fetch(`${baseUrl}/videos/${videoId}/content`, { headers }); if (!videoResponse.ok) throw new Error(await videoResponse.text());​ await mkdir("output", { recursive: true }); const outputPath = `output/${videoId}.mp4`; await writeFile(outputPath, Buffer.from(await videoResponse.arrayBuffer())); console.log(`Saved ${outputPath}`);

ما هي معلمات واجهة Wan 2.7 API؟

مطابقة المعلمات بين CometAPI وواجهة Alibaba الأصلية

توضح هذه المطابقة سبب عدم إمكانية لصق الأمثلة المنسوخة من Alibaba Cloud كما هي في CometAPI. ترتبط قدرة النموذج، لكن طبقة الوصول والمخطط مختلفان.

كيفية كتابة مطالبات أفضل لـ Wan 2.7: أمثلة

يُعرِّف مُدخل فيديو عملي ما يجب أن يبقى ثابتًا وما يجب أن يتغير بمرور الوقت. استخدم هذه البنية:

Subject + action + environment + camera movement + lighting + visual style + timeline + audio direction + constraints

مطالبة لقطة واحدة

A red vintage roadster drives along a wet coastal highway at blue hour. The camera tracks low beside the front wheel, then rises smoothly to reveal ocean cliffs. Realistic reflections, restrained motion blur, cinematic 35mm look, no text or logos.

مطالبة متعددة اللقطات

Create a cinematic detective sequence with consistent character identity. Shot 1 [0-2s]: a rain-soaked city street at night, neon reflected in puddles. Shot 2 [2-4s]: the detective enters an old building; slow handheld follow shot. Shot 3 [4-5s]: close-up of a clue under a narrow flashlight beam. Preserve the same coat, face and lighting palette across all shots. No captions.

مطالبة صورة إلى فيديو

Preserve the subject's face, clothing and background layout. The subject looks up, turns slightly toward the window and takes one step forward. Slow camera push-in, warm light gradually increases, natural hair and fabric motion, no new objects.

إرشادات المطالبة السلبية

استخدم المطالبات السلبية لقمع أنماط الإخفاق المتكررة بدلًا من وصف المشهد المرغوب مرة ثانية. تكون قائمة موجزة مثل low resolution، deformed hands، duplicated limbs، flicker، unstable face، unreadable text و watermark مفيدة عادةً أكثر من فقرة طويلة متناقضة.

كم تبلغ تكلفة واجهة Wan 2.7 API؟

يسرد مسار CometAPI الحالي Wan 2.7 بسعر $0.08 لكل ثانية لدقة 720p و$0.12 لكل ثانية لدقة 1080p. لذا فإن التكلفة التقديرية هي دالة مباشرة لمدة التوليد والدقة المختارة.

Estimated video cost = price per second x generated duration in seconds

مصدر البيانات: CometAPI live model pricing**.

تفسير التسعير: لا تدّع أن مسار المُجمِّع أرخص من Alibaba Cloud بدون مقارنة نفس المنطقة، ومتغير النموذج، والدقة، والمدة، ووضع الصوت، ووحدة الفوترة. يُعد سعر الثانية الواضح والفوترة الموحّدة في CometAPI مزايا تكامل؛ أما ميزة السعر لدى المزوّد فتتطلب مقارنة على أساس متكافئ.

المقطع بدقة 1080p الذي يفشل في المراجعة الإبداعية أغلى من سعر توليده المُدرج لأن الفريق يجب أن يعيد توليده. للتخطيط الإنتاجي، اقسم إجمالي الإنفاق على عدد المقاطع المقبولة دون إعادة عمل.

Wan 2.7 مقابل Seedance 2.5 مقابل Vidu Q3 مقابل Veo 3.1

أكثر البدائل فائدة على نفس المنصة هي Seedance 2.5، Vidu Q3 و Veo 3.1. تقارن الجدول التالي ملاءمة سير العمل بدلًا من إعلان فائز عالمي. يمكن أن تتغير ميزات المسار، لذا تحقّق من المدخلات المتقدمة قبل الإنتاج.

نتائج المقارنة

• اختر Wan 2.7 عندما تكون أهمية التحكم في الإطار الأول/الأخير، والاستمرار، والإرشاد الصوتي ودفق عمل قابل للتحكم على نطاق واسع أكبر من طول المقطع الأقصى.
• اختر Seedance 2.5 عندما تكون أولوية السرد متعدد اللقطات الأطول والعمل الإبداعي كثيف المراجع.
• اختر Vidu Q3 عندما يكون التكرار السردي السريع، والصوت المتزامن والدفقات الموجهة للمبدعين محورية.
• اختر Veo 3.1 عندما تستحق الجودة السينمائية والواقعية البصرية والصوت المدمج تكلفة مسار أعلى.
• لا تختَر فائزًا من المواصفات وحدها. استخدم مجموعة مطالبات وأصول ثابتة، ثم قارن معدل المخرجات المقبولة والتكلفة الإنتاجية الإجمالية.

أفضل الممارسات الإنتاجية

دورة المهمة والموثوقية

• احتفظ بمعرّف المهمة فور إنشاء المهمة.
• استخدم استراتيجية تعرّف على التكرار (idempotency) في تطبيقك حتى لا يؤدي تكرار العميل إلى إنشاء مهام مدفوعة مكررة.
• استطلع بفاصل 10-15 ثانية وحد انتظار أقصى بدلًا من حلقة غير محدودة.
• ميّز بين إخفاقات HTTP العابرة وإخفاقات التوليد التي يعلنها المزوّد.
• استخدم تراجعًا أُسّيًا لأخطاء الشبكة أو تحديد المعدل، لكن لا تعاود محاولة انتهاكات سياسات المحتوى بشكل أعمى.
• علّم المهمة كمكتملة فقط بعد تنزيل المخرج والتحقق من أنه غير فارغ.
• لا تعتمد بشكل دائم على عنوان URL مؤقت للمزوّد؛ انسخ المخرجات المقبولة إلى تخزين خاضع لسيطرتك حيثما كان ذلك مسموحًا.

الجودة والتحكم في التكلفة

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

الأمان والحوكمة

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

الأخطاء الشائعة واستكشاف المشكلات

التوصية النهائية

تكمن القيمة العملية لـ Wan 2.7 في اتساع نطاق دفق الفيديو القابل للتحكم: نص إلى فيديو، تحريك الصور، الإطارات المثبتة، الاستمرار، التوليد الموجّه بالمرجع والسلوك الواعي بالصوت. عبر CometAPI، أسرع مسار هو التحقق من طلب مدته 5 ثوانٍ بدقة 720p مع نقطة النهاية غير المتزامنة الموحّدة، ثم إضافة مدخلات الصور ومخرجات 1080p بعد أن تصبح مراحل الإنشاء والاستطلاع والتنزيل موثوقة.

للإنتاج، احتفظ بالميزات الأصلية المتقدمة خلف فحوصات قدرة صريحة لأن المخطط الموحّد لـ CometAPI قد لا يعرِض كل حقول Alibaba. قارن Wan 2.7 مع البدائل باستخدام نفس المطالبات والأصول، واختر المسار الذي ينتج أقل تكلفة لكل فيديو مقبول بدلًا من أدنى سعر معلن.

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

ما هي واجهة Wan 2.7 API؟

هي عائلة توليد فيديو متعددة الوسائط قابلة للوصول عبر واجهة برمجة التطبيقات تغطي النص إلى فيديو، الصورة إلى فيديو، الدفقات الموجّهة بالمرجع وتحرير الفيديو. يعرِض CometAPI مسار العميل عبر معرّف النموذج wan2.7.

ما هو معرّف نموذج Wan 2.7 على CometAPI؟

استخدم wan2.7. لا تستبدله بمعرّفات Alibaba الأصلية مثل wan2.7-t2v إلا إذا كنت تستدعي Alibaba Cloud مباشرة.

أي نقطة نهاية تُنشئ فيديو Wan 2.7؟

أرسل طلب POST متعدد الأجزاء إلى https://api.cometapi.com/v1/videos. ثم استعلم /v1/videos/{video_id} ونزّل من /v1/videos/{video_id}/content.

هل يدعم Wan 2.7 النص إلى فيديو والصورة إلى فيديو؟

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

ما الدقات التي يدعمها Wan 2.7؟

يدعم مسار فيديو Wan 2.7 المنشور 720p و1080p. تسرد وثائق النص إلى فيديو الأصلية أيضًا أبعاد خرج خاصة بنسب الأبعاد لكلتا الفئتين.

ما طول الفيديو الممكن في Wan 2.7؟

تسمح واجهة النص إلى فيديو الأصلية لـ Wan 2.7 بمدد صحيحة من 2 إلى 15 ثانية مع افتراضي 5 ثوانٍ. استخدم القيم الموثقة لمسار CometAPI الذي تستدعيه.

هل يولد Wan 2.7 صوتًا؟

توثّق Alibaba التوليد الموجّه بالصوت والموسيقى الخلفية/المؤثرات الصوتية التلقائية المتطابقة عند إغفال الصوت. يجب التحقق من الحقول الصوتية الدقيقة المعروضة عبر المسار الموحّد قبل الإنتاج.

هل يمكن لـ Wan 2.7 استخدام الإطارين الأول والأخير؟

تدعم عائلة الصورة إلى فيديو الأصلية مسارات الإطار الأول والإطار الأول مع الأخير. أكّد الحقول المقابلة في المسار الموحّد على CometAPI قبل الاعتماد عليها.

هل واجهة Wan 2.7 API متزامنة أم غير متزامنة؟

هي غير متزامنة. يُرجع إنشاء المهمة معرّفًا؛ يجب على تطبيقك استطلاع الحالة وتنزيل النتيجة بعد الإكمال.

كم تكلفة Wan 2.7 على CometAPI؟

يسرد المسار المنشور $0.08 لكل ثانية لدقة 720p و$0.12 لكل ثانية لدقة 1080p. لذا فإن مقطعًا مدته 5 ثوانٍ يُقدَّر بـ $0.40 أو $0.60 على التوالي.

هل أستخدم Wan 2.7 أم Seedance 2.5 أم Vidu Q3 أم Veo 3.1؟

استخدم Wan 2.7 للتحكم الواسع، وSeedance 2.5 للسرد الأطول كثيف المراجع، وVidu Q3 للتكرار السردي السريع، وVeo 3.1 للمخرجات السينمائية عالية الجودة. تحقّق من الاختيار عبر اختبار A/B مضبوط.

هل يمكن لـ Wan 2.7 استكمال فيديو موجود؟

نعم ضمن عائلة النموذج الأصلية عبر مسار first_clip. يجب التحقق من التوافر ومطابقة المعلمات على المسار الموحّد لـ CometAPI.