توليد الصور والفيديو والصوت من خلال واجهة API واحدة

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

العثور على نموذج والتحقق من متطلباته

استخدم فهرس الوسائط و/v1/models?type=image,video,audio لمعرفة أنواع الوسائط المتاحة لحسابك. تحقّق من المعرّف الدقيق لكل نموذج، والمدخلات المقبولة، والخيارات المدعومة، وتنسيق المخرجات، ووحدة السعر. قد تُحتسب تكلفة نموذج الصور بحسب إعدادات المخرجات؛ وقد تعتمد تكلفة الفيديو على المدة والدقة؛ أما نماذج الصوت فقد تُحاسب بحسب طول النص أو المدة أو وحدة أخرى موثّقة. لا تقارن هذه الأسعار كما لو كانت كلها محسوبة برموز النص.

gpt-image-2 أحد نماذج الصور في الفهرس. تعرض صفحة النموذج ووثائق الوسائط نسب الأبعاد المدعومة والدقة وخيارات التوليد والتحرير. لنماذج الفيديو مدخلاتها الخاصة وقد يستغرق تنفيذها وقتًا أطول. تختلف ميزات الصوت من نموذج إلى آخر؛ تحقّق من قائمة الوسائط الحالية قبل الوعد بعملية معيّنة في واجهة المستخدم.

إرسال مهمة لتوليد صورة

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

curl https://getvibeapi.com/api/media/generate \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "رسم توضيحي تحريري أنيق لمكتب مطوّر، بلا نص",
    "opts": {"aspect_ratio":"16:9", "resolution":"1K", "mode":"text-to-image"}
  }'

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

الاستعلام عن الحالة أو استلام إشعار عبر webhook

للتكاملات الصغيرة، استعلم عن نقطة نهاية المهمة على فترات معتدلة، وتوقف عندما تصل المهمة إلى حالة نهائية. تشمل الحالات submitting وprocessing وsuccess وfail وexpired. يؤدي الاستعلام كل بضعة أجزاء من الثانية إلى زيادة حركة المرور من دون تسريع التوليد. أما الدفعات الإنتاجية، فاضبط webhook الموثّق واجعل معالجة الاستدعاء قابلة للتكرار بأمان، حتى لا تؤدي الإشعارات المكررة إلى إنشاء أصول مكررة.

curl "https://getvibeapi.com/api/media/jobs/$JOB_ID" \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

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

يتطلب الفيديو والصوت معالجة خاصة بكل نموذج

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

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

الميزانية وسلوك الإخفاق

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

تجنب تضمين المطالبات وعناوين URL للوسائط في السجلات العامة ما لم تسمح سياسة الخصوصية بذلك. احجب بيانات الاعتماد، وفرض حدودًا للتحميل، وتجنب إتاحة الأصول الخاصة المُولّدة عبر روابط عامة. عند إجراء تعديلات، احتفظ بالأصل منفصلًا إلى أن تُراجَع النتيجة.

قائمة التحقق قبل الإنتاج

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

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