دليل Sora 2 Character API الكامل: طريقتان لإنشاء شخصيات قابلة لإعادة الاستخدام وتحقيق اتساق الشخصيات عبر الفيديوهات

طريقتان لإنشاء الشخصيات في Sora 2 Character API

الطريقة الأولى: الاستخراج من رابط الفيديو (video_url)

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

نموذج الطلب:

import requests
import json

url = "https://api.openai.com/v1/sora/characters"

payload = json.dumps({
    "model": "sora-2-character",
    "url": "https://cdn.openai.com/sora/videos/example-video.mp4",
    "timestamps": "5,8"
})

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.json())

شرح المعاملات:

عن معامل timestamps:

• الصيغة: "بداية,نهاية" (بالثواني)
• مثال: "5,8" يعني استخراج الشخصية من الثانية 5 إلى الثانية 8
• إذا لم تحدده: سيقوم النظام بمحاولة تحديد الشخصية الرئيسية من الفيديو بالكامل
• نصيحة: اختر نطاقاً زمنياً تظهر فيه الشخصية بوضوح ومن زوايا متعددة للحصول على أفضل نتيجة

الطريقة الثانية: الاستخراج من معرّف المهمة (from_task)

هذه الطريقة ممتازة عندما تريد استخراج شخصية من فيديو قمت بإنشائه للتو باستخدام Sora 2. بدلاً من انتظار رفع الفيديو والحصول على رابط، يمكنك مباشرة استخدام task_id الخاص بمهمة التوليد.

نموذج الطلب:

import requests
import json

url = "https://api.openai.com/v1/sora/characters"

payload = json.dumps({
    "model": "sora-2-character",
    "from_task": "video_f751ab8c3d2e4f9b8a1c2d3e4f5g6h7i",
    "timestamps": "3,6"
})

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.json())

شرح المعاملات:

سير العمل النموذجي:

# الخطوة 1: إنشاء فيديو جديد
create_response = requests.post(
    "https://api.openai.com/v1/sora/generate",
    headers=headers,
    json={
        "model": "sora-2",
        "prompt": "رائد فضاء يستكشف كوكباً بعيداً"
    }
)

task_id = create_response.json()['id']
# task_id = "video_f751ab8c3d2e4f9b8a1c2d3e4f5g6h7i"

# الخطوة 2: استخراج الشخصية من الفيديو الذي أنشأته
character_response = requests.post(
    "https://api.openai.com/v1/sora/characters",
    headers=headers,
    json={
        "model": "sora-2-character",
        "from_task": task_id,
        "timestamps": "2,5"
    }
)

character_id = character_response.json()['id']
# character_id = "@char_abc123xyz..."

# الخطوة 3: استخدام الشخصية في فيديو جديد
new_video = requests.post(
    "https://api.openai.com/v1/sora/generate",
    headers=headers,
    json={
        "model": "sora-2",
        "prompt": f"{character_id} يمشي في مدينة مستقبلية"
    }
)

مقارنة الطريقتين: أيهما أفضل؟

توصياتنا:

• 🚀 للإنتاج الاحترافي والمتسلسل: استخدم from_task – أسرع وأكثر استقراراً
• 🔄 لاستخراج شخصيات من مصادر متنوعة: استخدم video_url – أكثر مرونة
• 💡 للمبتدئين: ابدأ بـ from_task لفهم النظام، ثم انتقل لـ video_url عند الحاجة

فهم معامل timestamps بعمق

معامل timestamps هو مفتاح الحصول على شخصية دقيقة ومتسقة. دعنا نفهمه بالتفصيل:

الصيغة الأساسية

"timestamps": "بداية,نهاية"  # بالثواني

أمثلة عملية:

# مثال 1: استخراج من الثانية 5 إلى 8
"timestamps": "5,8"

# مثال 2: استخراج من بداية الفيديو (0) إلى الثانية 3
"timestamps": "0,3"

# مثال 3: استخراج من الثانية 10 إلى 15
"timestamps": "10,15"

# مثال 4: حذف المعامل - النظام يختار تلقائياً
# لا تضع timestamps في الطلب

كيف تختار النطاق الزمني المناسب؟

اختيار النطاق الزمني الأمثل لـ timestamps

0s 5s 10s 15s 20s

نطاق جيد

✓ النطاق المثالي: 3-5 ثوانٍ

معايير اختيار النطاق الزمني

✓ الشخصية ظاهرة بوضوح ✓ إضاءة جيدة على الوجه ✓ زوايا متعددة إن أمكن ✓ مدة 3-5 ثوانٍ كافية

✗ تجنب المشاهد السريعة ✗ تجنب الإضاءة الخافتة ✗ تجنب الحركة السريعة ✗ تجنب الانسداد الجزئي

💡 نصيحة: إذا لم تكن متأكداً، اترك timestamps فارغاً – سيختار النظام تلقائياً

نصائح عملية:

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

أمثلة عملية كاملة

مثال 1: إنشاء IP للعلامة التجارية

تخيل أنك تريد إنشاء شخصية تميمة (mascot) لعلامتك التجارية:

import requests
import json

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
}

# الخطوة 1: إنشاء فيديو أولي للشخصية
initial_video = requests.post(
    "https://api.openai.com/v1/sora/generate",
    headers=headers,
    json={
        "model": "sora-2",
        "prompt": "شخصية كرتونية ودودة على شكل دب أزرق، يرتدي قبعة حمراء، يبتسم ويلوح بيده"
    }
)

task_id = initial_video.json()['id']
print(f"معرّف المهمة: {task_id}")

# انتظر حتى يكتمل التوليد...

# الخطوة 2: استخراج الشخصية
character = requests.post(
    "https://api.openai.com/v1/sora/characters",
    headers=headers,
    json={
        "model": "sora-2-character",
        "from_task": task_id,
        "timestamps": "2,5"  # اختر نطاقاً تظهر فيه الشخصية بوضوح
    }
)

character_id = character.json()['id']
print(f"معرّف الشخصية: {character_id}")
# مثال: @char_xyz789abc

# الخطوة 3: استخدام الشخصية في سيناريوهات مختلفة
scenarios = [
    "يرقص في حفلة",
    "يشرب القهوة في مقهى",
    "يركب دراجة في الحديقة",
    "يقرأ كتاباً في المكتبة"
]

for scenario in scenarios:
    video = requests.post(
        "https://api.openai.com/v1/sora/generate",
        headers=headers,
        json={
            "model": "sora-2",
            "prompt": f"{character_id} {scenario}"
        }
    )
    print(f"فيديو جديد: {video.json()['id']} - {scenario}")

النتيجة: ستحصل على سلسلة فيديوهات تحتوي على نفس الشخصية بالضبط في سيناريوهات مختلفة!

مثال 2: استخراج شخصية من فيديو موجود

لنفترض أن لديك فيديو دعائي سابق وتريد استخراج الشخصية منه:

import requests
import json

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
}

# استخراج الشخصية من فيديو موجود
character = requests.post(
    "https://api.openai.com/v1/sora/characters",
    headers=headers,
    json={
        "model": "sora-2-character",
        "url": "https://yourbrand.com/videos/promo-2024.mp4",
        "timestamps": "8,12"  # الشخصية تظهر بوضوح من 8-12 ثانية
    }
)

character_id = character.json()['id']
print(f"تم استخراج الشخصية بنجاح: {character_id}")

# الآن يمكنك استخدامها في حملة جديدة
new_campaign = requests.post(
    "https://api.openai.com/v1/sora/generate",
    headers=headers,
    json={
        "model": "sora-2",
        "prompt": f"{character_id} يعرض منتجنا الجديد في متجر عصري"
    }
)

print(f"فيديو الحملة الجديدة: {new_campaign.json()['id']}")

معالجة الأخطاء الشائعة

خطأ: "Invalid timestamps format"

# ❌ خطأ
"timestamps": "5-8"  # صيغة خاطئة

# ✅ صحيح
"timestamps": "5,8"  # استخدم الفاصلة

خطأ: "Video URL not accessible"

# تأكد من:
# 1. الرابط صالح ومتاح للعموم
# 2. الفيديو بصيغة مدعومة (MP4, MOV, etc.)
# 3. لا يوجد قيود جغرافية على الرابط

# ✅ مثال صحيح
"url": "https://cdn.yoursite.com/public/video.mp4"

خطأ: "Task not found"

# تأكد من:
# 1. task_id صحيح
# 2. المهمة اكتملت بنجاح
# 3. المهمة لم تنتهِ صلاحيتها (عادة 30 يوماً)

# يمكنك التحقق من حالة المهمة أولاً:
status = requests.get(
    f"https://api.openai.com/v1/sora/tasks/{task_id}",
    headers=headers
)
print(status.json())

الخلاصة والتوصيات

Sora 2 Character API تفتح أمامك إمكانيات رائعة لإنشاء محتوى فيديو متسق واحترافي:

✅ استخدم from_task عندما تعمل ضمن سير عمل Sora – أسرع وأكثر استقراراً
✅ استخدم video_url عندما تحتاج المرونة لاستخدام مصادر متنوعة
✅ أتقن timestamps لتحديد أفضل اللحظات لاستخراج الشخصية
✅ جرّب وتعلّم – ابدأ بمشاريع صغيرة ثم توسّع تدريجياً

الخطوة التالية؟
ابدأ التجربة مع APIYI – منصة موثوقة لـ API نماذج الذكاء الاصطناعي، توفر أسعاراً تنافسية وتجربة مجانية لتبدأ رحلتك في إنشاء محتوى الفيديو باستخدام الذكاء الاصطناعي!

المراجع والروابط المفيدة:

• التوثيق الرسمي لـ OpenAI Sora
• APIYI – منصة API للذكاء الاصطناعي
• دليل Sora 2 الشامل

واجهة Sora 2 للشخصيات – طريقتان للإنشاء

الطريقة الأولى: استخراج الشخصية من رابط الفيديو

هذه هي الطريقة الأكثر مباشرة، وتناسب الحالات التي لديك فيها فيديو جاهز.

شرح معاملات الطلب:

مثال كامل للطلب:

curl https://api.apiyi.com/sora/v1/characters \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "sora-2-character",
    "url": "https://your-cdn.com/video/character-source.mp4",
    "timestamps": "5,8"
  }'

⚠️ ملاحظات مهمة:

1. رابط الفيديو يجب أن يكون متاحاً عبر الإنترنت: خوادم OpenAI تحتاج إمكانية الوصول للفيديو
2. إعداد CDN عالمياً: إذا كنت تستخدم OSS/CDN، تأكد من ضبطه للتسريع العالمي لتجنب عدم قدرة خوادم OpenAI (عادة في الخارج) على الوصول
3. النطاق الزمني timestamps:
   • الفرق الأدنى: ثانية واحدة
   • الفرق الأقصى: 3 ثوانٍ
   • مثال: "5,8" يعني من الثانية 5 إلى الثانية 8 في الفيديو

الطريقة الثانية: إعادة استخدام الشخصية عبر معرّف المهمة

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

شرح معاملات الطلب:

مثال كامل للطلب:

curl https://api.apiyi.com/sora/v1/characters \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "sora-2-character",
    "from_task": "video_f751abfd-87a9-46e2-9236-1d94743c5e3e",
    "timestamps": "5,8"
  }'

مزايا هذه الطريقة:

• ✅ لا حاجة لرفع الفيديو، مما يوفر عرض النطاق الترددي
• ✅ إعادة استخدام مباشرة للفيديوهات المُنشأة
• ✅ سير عمل أكثر سلاسة، مناسب للمعالجة الدفعية
• ✅ تجنب مشاكل انتهاء صلاحية رابط الفيديو أو الوصول إليه

توصية: استخدم واجهة Sora 2 للشخصيات عبر APIYI apiyi.com، حيث توفر المنصة خدمة اتصال مستقرة مع رصيد تجريبي مجاني.

مقارنة بين طريقتي Sora 2 Character API

كيف تختار الطريقة المناسبة؟

اختر طريقة رابط الفيديو:

• لديك فيديو جاهز (مثل فيديو حقيقي مُصوّر، أو فيديو منزّل من منصة أخرى)
• تحتاج استخراج شخصية من فيديو لم يُنشأ بواسطة Sora

اختر طريقة معرّف المهمة:

• تستخدم واجهة Sora 2 API لإنشاء فيديوهات بشكل دفعي
• ترغب في استخراج شخصية من فيديو مُنشأ بالفعل لاستخدامها في فيديوهات لاحقة من نفس السلسلة
• تبحث عن سير عمل آلي أكثر سلاسة

شرح معامل timestamps في Character API لـ Sora 2

timestamps هو المعامل الأكثر أهمية في Character API، فهو يحدد الفترة الزمنية من الفيديو التي سيتم استخراج الشخصية منها.

قواعد تنسيق timestamps

نصائح لضبط timestamps

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

مثال توضيحي:

لنفترض أن لديك فيديو مدته 10 ثوانٍ، تظهر فيه الشخصية من الأمام بوضوح في الثواني 2-4، ومن الجانب أثناء الحركة في الثواني 6-9:

// موصى به: اختيار المقطع الأمامي الواضح
{
  "timestamps": "2,4"
}

// غير موصى به: الشخصية من الجانب أثناء الحركة
{
  "timestamps": "6,9"
}

سير العمل الكامل لـ Character API في Sora 2

مثال بلغة Python

import requests
import time

# إعدادات واجهة APIYI
API_BASE = "https://api.apiyi.com/sora/v1"
API_KEY = "sk-your-api-key"

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

def create_character_from_url(video_url: str, timestamps: str) -> dict:
    """الطريقة الأولى: إنشاء شخصية من رابط فيديو"""
    response = requests.post(
        f"{API_BASE}/characters",
        headers=headers,
        json={
            "model": "sora-2-character",
            "url": video_url,
            "timestamps": timestamps
        }
    )
    return response.json()

def create_character_from_task(task_id: str, timestamps: str) -> dict:
    """الطريقة الثانية: إنشاء شخصية من معرّف المهمة"""
    response = requests.post(
        f"{API_BASE}/characters",
        headers=headers,
        json={
            "model": "sora-2-character",
            "from_task": task_id,
            "timestamps": timestamps
        }
    )
    return response.json()

# مثال على الاستخدام
# الطريقة الأولى: الإنشاء من رابط فيديو
result1 = create_character_from_url(
    video_url="https://your-cdn.com/video/hero.mp4",
    timestamps="5,8"
)
print(f"مهمة إنشاء الشخصية: {result1}")

# الطريقة الثانية: الإنشاء من معرّف المهمة
result2 = create_character_from_task(
    task_id="video_f751abfd-87a9-46e2-9236-1d94743c5e3e",
    timestamps="2,4"
)
print(f"مهمة إنشاء الشخصية: {result2}")

import requests
import time

API_BASE = "https://api.apiyi.com/sora/v1"
API_KEY = "sk-your-api-key"

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

def create_character(video_url: str, timestamps: str) -> str:
    """إنشاء شخصية وإرجاع معرّفها"""
    # 1. إرسال طلب إنشاء الشخصية
    response = requests.post(
        f"{API_BASE}/characters",
        headers=headers,
        json={
            "model": "sora-2-character",
            "url": video_url,
            "timestamps": timestamps
        }
    )
    task_data = response.json()
    task_id = task_data.get("task_id")

    # 2. الانتظار حتى اكتمال المهمة
    while True:
        status_response = requests.get(
            f"{API_BASE}/characters/{task_id}",
            headers=headers
        )
        status_data = status_response.json()

        if status_data.get("status") == "completed":
            return status_data.get("character_id")
        elif status_data.get("status") == "failed":
            raise Exception(f"فشل إنشاء الشخصية: {status_data}")

        time.sleep(5)  # التحقق كل 5 ثوانٍ

def generate_video_with_character(prompt: str, character_id: str) -> str:
    """توليد فيديو باستخدام الشخصية"""
    # الإشارة إلى الشخصية في الـ prompt عبر @character_id
    full_prompt = f"@{character_id} {prompt}"

    response = requests.post(
        f"{API_BASE}/videos",
        headers=headers,
        json={
            "model": "sora-2",
            "prompt": full_prompt,
            "duration": 8,
            "resolution": "1080p"
        }
    )
    return response.json()

# مثال على السير الكامل
if __name__ == "__main__":
    # الخطوة 1: إنشاء الشخصية
    character_id = create_character(
        video_url="https://your-cdn.com/video/hero.mp4",
        timestamps="5,8"
    )
    print(f"تم إنشاء الشخصية بنجاح، المعرّف: {character_id}")

    # الخطوة 2: استخدام الشخصية لتوليد سلسلة فيديوهات
    scenes = [
        "walking through a futuristic city at night",
        "sitting in a coffee shop, reading a book",
        "running on a beach at sunset"
    ]

    for i, scene in enumerate(scenes):
        result = generate_video_with_character(scene, character_id)
        print(f"مهمة توليد الفيديو {i+1}: {result}")

ملاحظة: من خلال الوصول إلى Character API لـ Sora 2 عبر منصة APIYI apiyi.com، ستحصل على إمكانيات إدارة كاملة للشخصيات بالإضافة إلى الدعم الفني.

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

@char_abc123xyz يسير في مدينة مستقبلية، والأضواء النيون تتلألأ

الخلاصة

النقاط الأساسية لواجهة برمجة تطبيقات Sora 2 Character:

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

بعد إتقان واجهة Character API، يمكنك:

• إنشاء شخصيات افتراضية قابلة لإعادة الاستخدام لعلامتك التجارية
• إنتاج محتوى فيديو متسلسل بشخصيات متسقة
• تحقيق فيديوهات سردية متواصلة باحترافية

نوصي بالوصول إلى واجهة Sora 2 Character API عبر منصة APIYI apiyi.com، حيث توفر المنصة خدمة مستقرة وحصة تجريبية مجانية، لمساعدتك على البدء بسرعة في استخدام ميزة إنشاء الشخصيات.

📚 مراجع ومصادر

⚠️ ملاحظة حول تنسيق الروابط: جميع الروابط الخارجية تستخدم تنسيق اسم المصدر: domain.com لتسهيل النسخ دون إمكانية النقر المباشر، تجنباً لفقدان قيمة SEO.

1. الإصدار الرسمي لـ OpenAI Sora 2: مقدمة عن وظائف ومميزات Sora 2

   • الرابط: openai.com/index/sora-2/
   • الوصف: تعرف على المعلومات الرسمية ووظائف الشخصيات في Sora 2

2. مركز مساعدة OpenAI – ميزة Characters: دليل إنشاء واستخدام الشخصيات

   • الرابط: help.openai.com/en/articles/12435986-generating-content-with-characters
   • الوصف: شرح رسمي لكيفية استخدام ميزة الشخصيات

3. وثائق OpenAI API – توليد الفيديو: الوثائق التقنية لـ Sora API

   • الرابط: platform.openai.com/docs/guides/video-generation
   • الوصف: مواصفات واجهة API ووصف المعاملات

4. صفحة OpenAI Sora Characters: تقديم منتج ميزة الشخصيات

   • الرابط: openai.com/sora/characters/
   • الوصف: موقع المنتج وسيناريوهات استخدام ميزة الشخصيات

الكاتب: الفريق التقني
للتواصل التقني: نرحب بالنقاش في قسم التعليقات، لمزيد من المصادر يمكنك زيارة مجتمع APIYI التقني apiyi.com