> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# واجهة ByteDance Seedance API على Krea

> استخدم ByteDance Seedance 2.5 و2.0 عبر Krea API. ولّد مقاطع فيديو من النصوص أو الصور مع أمثلة REST وJavaScript، ومفاتيح API، وروابط التسعير.

توفّر Krea وصولًا عبر API إلى نماذج توليد الفيديو Seedance من ByteDance. استخدم Seedance API على Krea لتوليد مقاطع فيديو من النصوص، أو تحريك الصور، أو توجيه التوليد بمراجع من الصور والفيديو والصوت. تستخدم الطلبات رمز Krea API وعنوان URL الأساسي `https://api.krea.ai`.

## نماذج Seedance API المتاحة

| النموذج | نقطة نهاية POST | مدة الفيديو | دقة المخرجات |
| - | - | - | - |
| Seedance 2.5 | `/generate/video/bytedance/seedance-2-5` | من 4 إلى 30 ثانية | 480p و720p و1080p |
| Seedance 2.0 | `/generate/video/bytedance/seedance-2` | من 4 إلى 15 ثانية | 480p و720p و1080p و4K |
| Seedance 2.0 Fast | `/generate/video/bytedance/seedance-2-fast` | من 4 إلى 15 ثانية | 480p و720p |
| Seedance 2.0 Mini | `/generate/video/bytedance/seedance-2-mini` | من 4 إلى 15 ثانية | 480p و720p |

تدعم هذه النماذج تحويل النص إلى فيديو، والإطارات الافتتاحية والختامية، والوسائط المرجعية، والصوت الأصلي. راجع [مرجع API](https://www.krea.ai/docs/api-reference/introduction.md) للاطلاع على مخطط الطلب الحالي لكل نموذج. تحقّق من [تسعير API ↗](https://www.krea.ai/app/api/pricing) قبل إرسال أي مهمة، إذ يعتمد السعر على النموذج وإعدادات التوليد.

> [!NOTE]
>
> تتضمن نقطتا النهاية Seedance 2.0 وSeedance 2.0 Fast في Krea تحسينًا اختياريًا للموجّه وترقية للدقة من Krea تتجاوز النموذج الأساسي. ويتضمن Seedance 2.5 تحسينًا اختياريًا للموجّه من Krea. في طلبات تحرير الفيديو عبر Seedance 2.5 التي تستخدم `reference_videos`، يُستمد طول المخرجات ونسبة العرض إلى الارتفاع من الفيديو المصدر، ويتم تجاهل `duration` و`aspect_ratio` في هذه الطلبات.

## الحصول على مفتاح Seedance API

أنشئ رمز Krea API وأضف رصيد API من خلال [مفاتيح API والفوترة](https://www.krea.ai/docs/ar/developers/api-keys-and-billing.md). خزّن الرمز في متغير البيئة `KREA_API_KEY` على الخادم الخاص بك. أرسله بالصيغة `Authorization: Bearer $KREA_API_KEY`، ولا تكشفه أبدًا في شيفرة المتصفح.

رصيد الحوسبة في تطبيق Krea ورصيد API منفصلان. تستخدم طلبات Seedance عبر Krea API رصيد API الخاص بمساحة عملك.

## توليد فيديو

أرسل موجّهًا إلى نقطة النهاية Seedance 2.5 لتوليد فيديو من نص. تطلب هذه الأمثلة فيديو أفقيًا مدته خمس ثوانٍ بدقة 720p.

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body https://api.krea.ai/generate/video/bytedance/seedance-2-5 \
  -H "Authorization: Bearer $KREA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A slow camera orbit around a ceramic vase in warm studio light",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'
```

```javascript JavaScript theme={"theme":{"light":"github-light-default","dark":"vesper"}}
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.video("bytedance/seedance-2-5", {
  prompt: "A slow camera orbit around a ceramic vase in warm studio light",
  duration: 5,
  aspect_ratio: "16:9",
  resolution: "720p"
});

const completed = await krea.jobs.wait(job.job_id);
console.log(completed.result.urls[0]);
```

ثبّت JavaScript SDK باستخدام `npm install @krea-ai/sdk`. يُرجع طلب REST قيمة `job_id`، وليس الفيديو النهائي. استعلم عن `GET /jobs/{job_id}` كل 2 إلى 5 ثوانٍ حتى تصبح قيمة `status` هي `completed`، ثم اقرأ رابط الفيديو من `result.urls[0]`. أوقف الاستعلام عند `failed` أو `cancelled`. تتولى الدالة `jobs.wait` في SDK عملية الاستعلام نيابةً عنك.

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body "https://api.krea.ai/jobs/YOUR_JOB_ID" \
  -H "Authorization: Bearer $KREA_API_KEY"
```

في تكاملات الإنتاج، استخدم [webhooks](https://www.krea.ai/docs/ar/developers/webhooks.md) لاستقبال أحداث الاكتمال. راجع [دورة حياة المهمة](https://www.krea.ai/docs/ar/developers/job-lifecycle.md) و[الأخطاء وتصحيحها](https://www.krea.ai/docs/ar/developers/errors-and-debugging.md) للاطلاع على حالات المهام ومعالجة الإخفاقات.

## تحريك صورة

لتحويل صورة إلى فيديو باستخدام Seedance، استخدم نقطة النهاية نفسها وأضف `start_image` إلى طلبك. مرّر رابط صورة يمكن الوصول إليه علنًا، أو رابط أصل مرفوع، أو URI بيانات بترميز base64.

```json theme={"theme":{"light":"github-light-default","dark":"vesper"}}
{
  "prompt": "The camera slowly moves closer as soft light shifts across the scene",
  "start_image": "https://your-domain.example/product.png",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}
```

استبدل `start_image` برابط صورتك. للتحكم في الإطار الأخير، أضف `end_image`. للتوليد الموجَّه بالمراجع، استخدم `reference_images` و`reference_videos` و`reference_audios` وفقًا لـ[مخطط API](https://www.krea.ai/docs/api-reference/introduction.md) الخاص بالنموذج المحدد.

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

### هل توفّر Krea واجهة ByteDance Seedance API؟

نعم. توفّر Krea نماذج ByteDance Seedance 2.5 وSeedance 2.0 وSeedance 2.0 Fast وSeedance 2.0 Mini عبر واجهة REST API على `https://api.krea.ai`. قم بالمصادقة باستخدام رمز Krea API وأرسل طلبًا إلى إحدى نقاط نهاية Seedance المذكورة أعلاه.

### هل يمكنني استخدام Seedance لتحويل النص إلى فيديو والصورة إلى فيديو معًا؟

نعم. أرسل `prompt` لتحويل النص إلى فيديو، أو أضف `start_image` لتحريك صورة. يستخدم كلا المسارين نقطة النهاية نفسها لنموذج Seedance ويُرجعان مهمة غير متزامنة.

### هل أحتاج إلى مفتاح ByteDance API منفصل؟

لا. تستخدم استدعاءات Seedance عبر Krea رمز Krea API ورصيد API الخاص بمساحة عملك. لا تحتاج إلى إرسال بيانات اعتماد منفصلة من ByteDance مع هذه الطلبات.

### كم تبلغ تكلفة Seedance API على Krea؟

راجع [تسعير Krea API ↗](https://www.krea.ai/app/api/pricing) للاطلاع على أسعار Seedance الحالية والإعدادات المتاحة. تتم فوترة استخدام API بشكل منفصل عن رصيد الحوسبة في تطبيق Krea. لا تتم فوترة المهام الفاشلة والملغاة.

### هل يمكنني استدعاء Seedance من وكيل ذكاء اصطناعي؟

نعم. اربط وكيلًا بـ[خادم Krea MCP](https://www.krea.ai/docs/ar/developers/mcp.md) لاكتشاف نماذج الفيديو المتاحة ومخططاتها. يمكنك أيضًا استدعاء REST API أو JavaScript SDK مباشرةً من تطبيقك.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.