بدء سريع مع Kling V3.0 4K API

يتوفر Kling V3.0 4K على Novita AI كنقطتي نهاية مخصصتين لواجهة برمجة التطبيقات: kling-v3.0-4k-t2v لتحويل النص إلى فيديو و kling-v3.0-4k-i2v لتحويل الصورة إلى فيديو. ينتج كلاهما مخرجات أصلية بدقة 3840×2160، ويدعمان مددًا تتراوح من 3 إلى 15 ثانية، ويتبعان نفس نمط المهمة غير المتزامنة المستخدم عبر جميع واجهات برمجة تطبيقات الفيديو من Novita. إذا كان لديك بالفعل Kling V3.0 Standard أو Pro في سير عملك، فإن التبديل إلى طبقة 4K هو تغيير في معرف النموذج بسطر واحد.

يغطي هذا الدليل نقاط النهاية الخاصة بـ 4K فقط. للحصول على توليد صوت أصلي، أو تكوين متعدد اللقطات، أو تسعير Standard/Pro بالثانية، راجع نظرة عامة على إطلاق Kling 3.0 على Novita AI.

متى تستخدم Kling V3.0 4K مقابل Standard وPro

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

لا تحل محل Standard أو Pro في كل حالة استخدام. الاختبار والتجريب باستخدام الوصف أرخص في الدقات المنخفضة، ويستغرق توليد 4K وقتًا أطول لكل مهمة. سير العمل العملي هو الاختبار باستخدام Standard، ثم التبديل إلى kling-v3.0-4k-t2v أو kling-v3.0-4k-i2v للوصف النهائي المقبول.

استخدم kling-v3.0-4k-t2v عندما:

• يمكن وصف المشهد بالكامل في وصف
• لا توجد صورة مرجعية أو لا تهم

استخدم kling-v3.0-4k-i2v عندما:

• يجب أن يكون إطار أول محدد هو الأساس للمقطع المُنشأ
• تحتاج إلى مظهر ثابت للكائن من صورة مصدر

الخطوة 1: احصل على مفتاح API الخاص بك لـ Novita AI

سجل في novita.ai وأنشئ مفتاح API من لوحة التحكم. تتضمن الحسابات الجديدة أرصدة مجانية. قم بتخزين المفتاح كمتغير بيئة - لا تقم بتضمينه مباشرة في ملفات المصدر.

export NOVITA_API_KEY="your_api_key_here"

الخطوة 2: معرفات النماذج ونقاط النهاية

الوضع	معرف النموذج	نقطة النهاية
نص إلى فيديو	kling-v3.0-4k-t2v	POST https://api.novita.ai/v3/async/kling-v3.0-4k-t2v
صورة إلى فيديو	kling-v3.0-4k-i2v	POST https://api.novita.ai/v3/async/kling-v3.0-4k-i2v
استرجاع النتيجة	—	GET https://api.novita.ai/v3/async/task-result?task_id=<id>

تقبل كلتا نقطتي النهاية JSON، وتتطلبان رمز Bearer في رأس Authorization، وتعيدان task_id فورًا. يتم استرجاع الفيديو الفعلي بشكل منفصل من نقطة نهاية نتيجة المهمة.

مراجع API الرسمية:

• وثائق Kling v3.0 4K T2V
• وثائق Kling v3.0 4K I2V

الخطوة 3: أرسل طلبك الأول

curl -X POST https://api.novita.ai/v3/async/kling-v3.0-4k-t2v \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A lone lighthouse on a rocky coast at golden hour, cinematic wide shot, waves crashing",
    "negative_prompt": "blurry, low quality, distorted",
    "duration": 5,
    "aspect_ratio": "16:9",
    "cfg_scale": 0.5
  }'

يُعيد الرد task_id:

{
  "task_id": "t2v-kling-4k-abc123"
}

احفظ هذا المعرّف - ستحتاج إليه لاسترجاع النتيجة.

الخطوة 4: استقصِ نتيجة الفيديو

curl "https://api.novita.ai/v3/async/task-result?task_id=t2v-kling-4k-abc123" \
  -H "Authorization: Bearer $NOVITA_API_KEY"

تعيد المهمة المكتملة كائن task مع status: "TASK_STATUS_SUCCEED" ومصفوفة videos:

{
  "task": {
    "task_id": "t2v-kling-4k-abc123",
    "status": "TASK_STATUS_SUCCEED"
  },
  "videos": [
    {
      "video_url": "https://...",
      "video_url_ttl": 3600,
      "video_type": "mp4"
    }
  ]
}

قيم الحالة النموذجية: TASK_STATUS_QUEUED، TASK_STATUS_PROCESSING، TASK_STATUS_SUCCEED، TASK_STATUS_FAILED. قم ببناء حلقة الاستقصاء الخاصة بك حول هذه القيم - لا تفترض وقت انتظار ثابت، حيث يستغرق توليد 4K وقتًا أطول من 1080P.

الخطوة 5: طلب تحويل الصورة إلى فيديو

تتطلب نقطة نهاية تحويل الصورة إلى فيديو عنوان image_url بالإضافة إلى prompt. تحدد الصورة الإطار الأول؛ ويقوم النموذج بتوليد الحركة منه.

curl -X POST https://api.novita.ai/v3/async/kling-v3.0-4k-i2v \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "The lighthouse beam sweeps across the fog, slow dramatic movement",
    "negative_prompt": "fast cuts, shake, low quality",
    "image_url": "https://your-storage.example.com/lighthouse-frame.jpg",
    "duration": 5,
    "aspect_ratio": "16:9",
    "cfg_scale": 0.5
  }'

متطلبات الصورة (تحقق من الحدود الحالية في مرجع Novita API):

• الصيغ: .jpg, .jpeg, .png
• الحد الأقصى لحجم الملف: 10 ميجابايت
• الحد الأدنى للأبعاد: 300×300 بكسل

خطوة استرجاع النتيجة مماثلة لـ T2V - استقصِ /v3/async/task-result باستخدام task_id الذي تم إرجاعه.

أمثلة بلغة Python

T2V — نص إلى فيديو 4K

import os
import time
import requests

API_KEY = os.environ["NOVITA_API_KEY"]
BASE_URL = "https://api.novita.ai"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

def submit_t2v(prompt: str, duration: int = 5, aspect_ratio: str = "16:9") -> str:
    payload = {
        "prompt": prompt,
        "negative_prompt": "blurry, low quality",
        "duration": duration,
        "aspect_ratio": aspect_ratio,
        "cfg_scale": 0.5,
    }
    resp = requests.post(
        f"{BASE_URL}/v3/async/kling-v3.0-4k-t2v",
        headers=HEADERS,
        json=payload,
        timeout=30,
    )
    resp.raise_for_status()
    return resp.json()["task_id"]

def poll_result(task_id: str, interval: int = 10, max_wait: int = 600) -> dict:
    deadline = time.time() + max_wait
    while time.time() < deadline:
        resp = requests.get(
            f"{BASE_URL}/v3/async/task-result",
            headers=HEADERS,
            params={"task_id": task_id},
            timeout=30,
        )
        resp.raise_for_status()
        data = resp.json()
        status = data.get("task", {}).get("status", "")
        if status == "TASK_STATUS_SUCCEED":
            return data
        if status == "TASK_STATUS_FAILED":
            raise RuntimeError(f"Task failed: {data}")
        time.sleep(interval)
    raise TimeoutError(f"Task {task_id} did not complete within {max_wait}s")

if __name__ == "__main__":
    task_id = submit_t2v(
        prompt="A lone lighthouse on a rocky coast at golden hour, cinematic wide shot",
        duration=5,
        aspect_ratio="16:9",
    )
    print(f"Task submitted: {task_id}")
    result = poll_result(task_id)
    video_url = result["videos"][0]["video_url"]
    print(f"Video ready: {video_url}")

I2V — صورة إلى فيديو 4K

def submit_i2v(
    prompt: str,
    image_url: str,
    duration: int = 5,
    aspect_ratio: str = "16:9",
) -> str:
    payload = {
        "prompt": prompt,
        "negative_prompt": "blurry, low quality",
        "image_url": image_url,
        "duration": duration,
        "aspect_ratio": aspect_ratio,
        "cfg_scale": 0.5,
    }
    resp = requests.post(
        f"{BASE_URL}/v3/async/kling-v3.0-4k-i2v",
        headers=HEADERS,
        json=payload,
        timeout=30,
    )
    resp.raise_for_status()
    return resp.json()["task_id"]

استخدم نفس دالة poll_result لاسترجاع الفيديو المولد.

المعلمات الرئيسية

المعلمة	النوع	مطلوب	ملاحظات
prompt	string	نعم	وصف المشهد. اجعله محددًا: الموضوع، الحركة، زاوية الكاميرا، الإضاءة.
negative_prompt	string	لا	ما يجب قمعه: الضبابية، الاهتزاز، التشوهات، الأنماط غير المرغوب فيها.
duration	integer	لا	ثوانٍ من الفيديو. النطاق: 3–15. القيمة الافتراضية تختلف — راجع الوثائق.
aspect_ratio	string	لا	"16:9", "9:16", "1:1". القيمة الافتراضية: "16:9".
cfg_scale	float	لا	قوة الالتزام بالوصف. 0.5 هي قيمة بداية آمنة.
image_url	string	I2V فقط	صورة الإطار الأول. يجب أن يكون عنوان URL متاحًا للجمهور.

الدقة والمدة مقابل التكلفة

توليد 4K يكلف أكثر في الثانية من Standard أو Pro. قبل الالتزام بدفعة كاملة:

• اختبر الأوصاف باستخدام kling-v3.0-std-t2v مع duration: 3
• تحول إلى kling-v3.0-4k-t2v للأوصاف المقبولة فقط
• استخدم duration: 5 لمعظم المخرجات؛ احتفظ بـ 10-15 ثانية لمقاطع البطولة

التسعير وتقديرات التكلفة

تستخدم Novita AI الفوترة بالثانية لـ Kling V3.0 4K. تسعير طبقة 4K أعلى من Standard أو Pro — تحقق من novita.ai/models/kling/kling-v3.0-4k-t2v و novita.ai/models/kling/kling-v3.0-4k-i2v للحصول على الأسعار الحالية بالثانية قبل تشغيل دفعات الإنتاج.

للحصول على سياق حول طبقات Standard وPro، توثق نظرة عامة على إطلاق Kling 3.0 الأسعار بالثانية لتلك الطبقات. طبقة 4K مسعرة بشكل منفصل.

نمط تقدير التكلفة لأي نموذج بالثانية:

• حدد المدة لكل مقطع (مثلًا 5 ثوانٍ)
• اضرب في السعر لكل ثانية
• اضرب في العدد المتوقع للمقاطع المقبولة
• أضف حاجز إعادة المحاولة (10–20% لفشل الأوصاف)

استكشاف الأخطاء وإصلاحها

تم استلام task_id ولكن النتيجة لا تنجح أبدًا تستغرق مهام 4K وقتًا أطول من نظيراتها 1080P. قم بتمديد مهلة الاستقصاء إلى 10 دقائق على الأقل (max_wait=600). إذا بقيت المهمة في TASK_STATUS_PROCESSING بعد ذلك، تحقق من صفحة حالة Novita أو أعد إرسال الطلب.

TASK_STATUS_FAILED بدون تفاصيل الأسباب الأكثر شيوعًا هي: احتواء الوصف على محتوى غير مسموح به، أو عنوان image_url غير صالح أو غير قابل للوصول في وضع I2V، أو قيمة مدة خارج النطاق المدعوم. تحقق من المدخلات وأعد المحاولة بوصف أبسط.

تم رفض صورة I2V تحقق من أن الصورة متاحة للجمهور عبر عنوان URL مباشر (لا إعادة توجيه أو جدار مصادقة)، وأن الصيغة هي .jpg/.jpeg/.png، وأن الملف أقل من 10 ميجابايت، والأبعاد 300×300 بكسل على الأقل.

دقة إخراج غير متوقعة تستهدف نقاط نهاية 4K دقة 3840×2160. إذا كان المشغل أو الأداة اللاحقة تبلغ عن دقة أقل، تحقق مما إذا كانت تفك تشفير الملف بشكل صحيح. يجب أن يكون الإخراج المشفر من API بدقة 4K أصلية.

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

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

ما الدقة التي ينتجها kling-v3.0-4k-t2v؟

تستهدف نقطتي نهاية 4K إخراجًا أصليًا بدقة 3840×2160 (4K UHD). هذا عرض أجهزة — ليس تحسينًا من دقة أقل.

كيف يختلف Kling V3.0 4K عن V3.0 Standard وPro؟

ينتج Standard وPro إخراج 1080P. تضيف نقاط نهاية 4K دقة أصلية 3840×2160. Standard هو الأسرع والأرخص؛ يضيف Pro جودة بصرية أعلى بتكلفة معتدلة؛ 4K هو الخيار الأعلى دقة ويتم تسعيره وفقًا لذلك. المدة (3–15 ثانية) وشكل API غير المتزامن متماثلان عبر جميع الطبقات الثلاث.

هل يمكنني استخدام نقاط نهاية 4K مع نفس مفتاح API الخاص بـ Standard وPro؟

نعم. تستخدم جميع نقاط نهاية Kling V3.0 على Novita AI نفس مصادقة رمز Bearer. التغيير الوحيد بين الطبقات هو معرف النموذج ومسار نقطة النهاية.

هل يدعم Kling V3.0 4K توليد الصوت الأصلي؟

قد تكون علامة التوليد المشترك للصوت القياسية المتاحة على نقاط نهاية V3.0 Standard وPro مدعومة أيضًا على طبقة 4K. تحقق من صفحات مرجع API T2V و I2V للحصول على قائمة المعلمات الحالية بما في ذلك أي حقل with_audio.

كم من الوقت تستغرق مهمة توليد 4K؟

يستغرق توليد 4K وقتًا أطول من 1080P. توقع ما لا يقل عن 60-180 ثانية لمقطع مدته 5 ثوانٍ، اعتمادًا على حمل قائمة الانتظار. صمم منطق الاستقصاء الخاص بك بمهلة لا تقل عن 10 دقائق وتعامل مع TASK_STATUS_PROCESSING كحالة وسيطة عادية.

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

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

مقالات موصى بها

• Kling 3.0 الآن على Novita AI: توليد فيديو سينمائي بالذكاء الاصطناعي على نطاق واسع
• Kling O1 على Novita AI: أوضاع T2V وI2V وRef2V وتحرير الفيديو
• Kling V2.5 Turbo API على Novita AI: نص إلى فيديو وصورة إلى فيديو