Skip to main content

نظرة عامة

عند إيقاف دعم أحد النماذج في Krea API، فإننا نُبلّغ بذلك عبر ثلاث قنوات حتى يتمكن التكامل الخاص بك من التفاعل تلقائيًا:
  • رؤوس HTTP في كل استجابة ناجحة من نقطة نهاية موقوفة الدعم:
    • Deprecation: true
    • Sunset: Mon, 27 Apr 2026 00:00:00 GMT — الوقت الذي ستتوقف فيه نقطة النهاية عن قبول الطلبات (تاريخ بتنسيق RFC 1123)
    • Link: <https://docs.krea.ai/developers/deprecations#seedance-1-0-lite>; rel="deprecation"; type="text/html" — يشير إلى الإدخال في هذه الصفحة
  • OpenAPI: يتم تمييز العملية بـ deprecated: true ويبدأ الوصف بكتلة تحذير.
  • MCP list_models: تتضمن النماذج الموقوفة كائن deprecation بجانب مخططها.
بعد تاريخ الإيقاف، تعيد نقطة النهاية 410 Gone مع جسم منظم:
{
	"error": "model_unavailable",
	"reason": "deprecated",
	"message": "The model 'video/bytedance/seedance-1.0-lite' was deprecated on 2026-04-27. Provider has discontinued this model. Use 'video/bytedance/seedance-1.0-pro-fast' instead.",
	"sunset_date": "2026-04-27",
	"replacement": "video/bytedance/seedance-1.0-pro-fast",
	"migration_url": "https://docs.krea.ai/developers/deprecations#seedance-1-0-lite"
}
حقل error ثابت وآمن للتبديل بناءً عليه. يتوفر حقلا replacement وmigration_url عند وجود بديل موصى به.
يُفرض الإيقاف من جهة الخادم فور مرور التاريخ. يجب أن يتعامل الكود لديك مع أي استجابة 410 من نقطة نهاية نموذج على أنها نهائية — إعادة المحاولة لن تجدي نفعًا.

المُوقف حاليًا

seedream3

أُوقف في 2026-05-13. أوقفت ByteDance دعم النموذج. الترحيل: بدّل مسار طلبك من image/bytedance/seedream-3 إلى image/bytedance/seedream-5-lite.
- POST /generate/image/bytedance/seedream-3
+ POST /generate/image/bytedance/seedream-5-lite
إذا كنت تستدعي واجهة API عبر MCP، فحدّث وسيط model:
- { "model": "image/bytedance/seedream-3", "input": { ... } }
+ { "model": "image/bytedance/seedream-5-lite", "input": { ... } }

seedance-1-0-lite

أُوقف في 2026-04-27. أوقف المزوّد هذا النموذج. الترحيل: بدّل مسار طلبك من video/bytedance/seedance-1.0-lite إلى video/bytedance/seedance-1.0-pro-fast. أشكال الطلب والاستجابة متوافقة بخلاف ذلك.
- POST /generate/video/bytedance/seedance-1.0-lite
+ POST /generate/video/bytedance/seedance-1.0-pro-fast
إذا كنت تستدعي واجهة API عبر MCP، فحدّث وسيط model:
- { "model": "video/bytedance/seedance-1.0-lite", "input": { ... } }
+ { "model": "video/bytedance/seedance-1.0-pro-fast", "input": { ... } }

sora-2

أُوقف في 2026-04-27. أوقف المزوّد هذا النموذج. لا يوجد بديل مباشر في الوقت الحالي. إذا كنت تستخدم video/openai/sora-2، فقيّم نماذج تحويل النص إلى فيديو الأخرى في كتالوج الفيديو لدينا — تُعدّ video/google/veo-3.1 وvideo/runway/gen-4.5 وvideo/bytedance/seedance-1.0-pro أقرب الخيارات للحصول على مقاطع قصيرة عالية الجودة.
- POST /generate/video/openai/sora-2
+ POST /generate/video/<chosen-replacement>

كيفية اكتشاف الإيقاف في الكود لديك

إذا كنت تريد اكتشاف عمليات الإيقاف قبل تاريخها بدلًا من التفاعل مع 410، فراقب رأس Deprecation: true في أي استجابة وأظهره في سجلاتك أو تنبيهاتك. إليك مثالًا مبسّطًا:
const response = await fetch(url, options);
if (response.headers.get('deprecation') === 'true') {
	const sunset = response.headers.get('sunset');
	const link = response.headers.get('link');
	console.warn(`Endpoint deprecated. Sunset: ${sunset}. Migration: ${link}`);
}
بالنسبة لعملاء MCP، افحص حقل deprecation في كل نموذج تُعيده list_models وget_model_schema.