دليل Python

واجهة ذكاء اصطناعي من الصورة إلى الفيديو مع Python

أنشئ مهمة من صورة واحدة وتتبعها بأمان ثم نزّل الفيديو المكتمل.

Python: إنشاء وتتبع وتنزيل
import os
import time
import requests

base_url = "https://sora2-api.com"
headers = {
    "Authorization": f"Bearer {os.environ['TIKDEK_API_KEY']}",
    "Content-Type": "application/json",
}

created = requests.post(
    f"{base_url}/api/v1/video/sora-video",
    headers=headers,
    json={
        "model": "sora-2-pro",
        "prompt": "Slow camera push-in, rain moving across the frame",
        "url": "https://example.com/reference-frame.jpg",
        "aspectRatio": "16:9",
        "webHook": "-1",
        "isPublic": False,
    },
    timeout=30,
)
created.raise_for_status()
task_id = created.json()["data"]["id"]

for _ in range(90):
    response = requests.post(
        f"{base_url}/api/video-generations/check-result",
        headers=headers,
        json={"taskId": task_id},
        timeout=30,
    )
    response.raise_for_status()
    task = response.json()["data"]

    if task["status"] == "succeeded":
        video = requests.get(task["result_url"], timeout=120)
        video.raise_for_status()
        open("result.mp4", "wb").write(video.content)
        break

    if task["status"] == "failed":
        raise RuntimeError(task.get("error_message") or "Generation failed")

    time.sleep(4)
else:
    raise TimeoutError(f"Task {task_id} did not finish in time")

دورة طلب Python كاملة

يستخدم المثال نقاط Tikdek الفعلية ويتعامل مع جميع الحالات النهائية.

سورا 2 + مستقر + برو

اختر سلسلة النموذج التي تتوافق مع احتياجات الجودة والتكلفة الخاصة بك: sora-2، أو sora-2-stable، أو sora-2-pro.

الاقتراع المتوقع

أنشئ مهمة، ثم قم باستقصاء نقطة نهاية نتيجة التحقق للحفاظ على مزامنة الحالة والتقدم بدون SSE.

20 طلبًا متزامنًا

معالجة ما يصل إلى 20 مهمة إنشاء فيديو في وقت واحد. اتصل بنا للحصول على حدود أعلى.

تدفق التكامل الموصى به

اجعل التكامل مناسباً للإنتاج

احتفظ بالمفاتيح في الخادم وحدد المحاولات وسجل معرفات المهام واحفظ النتائج سريعاً.

قم بإنشاء المهمة

أرسل طلب Tikdek مع الموجه الخاص بك، ثم قم بتخزين معرف المهمة الذي تم إرجاعه.

تتبع التقدم

اتصل بنقطة نهاية نتيجة التحقق حتى تصبح الحالة ناجحة أو فاشلة.

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

استخدم عناوين URL المدعومة بالتخزين في result_url/result_urls لعرض الفيديو الذي تم إنشاؤه أو تنزيله.

الأسئلة المتداولة

كيف يمكنني التحقق من طلباتي؟

قم بإنشاء مفتاح API في وحدة التحكم، ثم قم بتضمينه كتفويض: Bearer YOUR_API_KEY. يمكن تدوير المفاتيح في أي وقت.

كيف يجب أن أقوم باستطلاع النتائج؟

بعد استدعاء إنشاء، قم بتخزين معرف المهمة. اتصل بـ /api/video- Generations/check-result كل 3 إلى 5 ثوانٍ حتى تنجح الحالة أو تفشل، ثم استخدم result_url/result_urls.

كيف يتم التعامل مع الاعتمادات للفشل؟

نقوم تلقائيًا برد الأرصدة عند فشل المهمة ونعيد Refund_trans_no plus Credits_refunded=true في حمولة نتيجة التحقق لمسارات التدقيق.

من النص البرمجي إلى الإنتاج

أنشئ مفتاحاً وشغّل المثال ثم أضف webhook عندما يزيد الحمل.