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

# واجهة برمجة تطبيقات الصور الناطقة من Kling (Kling Talking Photo)

> Kling video generation API guide - Ace Data Cloud

بنقرة واحدة، حوّل **صورة واحدة + مقطعًا صوتيًا واحدًا** إلى «فيديو ناطق». تُكمل الخدمة داخليًا خطوتين تلقائيًا: أولًا استخدام image2video لتحريك الصورة، ثم استخدام lip-sync لمزامنة حركة الشفاه مع الصوت. ما عليك سوى إجراء استدعاء **واحد**.

* **عنوان الواجهة**: `POST https://api.acedata.cloud/kling/talking-photo`
* **الفوترة**: حسب المدة، 5 ثوانٍ **16.45 Credits**، و10 ثوانٍ **30.45 Credits** (= السعر المدمج لـ image2video + lip-sync)

## رؤوس الطلب

| الحقل | القيمة |
| - | - |
| `authorization` | `Bearer ${API_KEY}` |
| `content-type` | `application/json` |

## معلمات الطلب

| المعلمة | النوع | مطلوب | الافتراضي | الوصف |
| - | - | - | - | - |
| `image_url` | string | نعم | — | عنوان URL عام لصورة الشخص، ويُنصح بأن تكون واضحة ووجهًا أماميًا |
| `audio_url` | string | نعم | — | عنوان URL عام للصوت المُشغِّل (.mp3/.wav/.m4a/.aac، ≤5MB) |
| `prompt` | string | لا | — | كلمات توجيهية للحركة/تعبيرات الوجه في مرحلة تحريك الصورة |
| `model` | string | لا | `kling-v2-1-master` | نموذج Kling المستخدم لتحريك الصورة |
| `duration` | integer | لا | `5` | مدة الفيديو (5 أو 10 ثوانٍ) |
| `mode` | string | لا | `pro` | جودة التحريك (std/pro) |
| `callback_url` | string | لا | — | عند تمريره أو عند `async=true` يتم إرجاع task\_id بشكل غير متزامن |
| `async` | boolean | لا | `false` | وضع غير متزامن، يُستخدم مع استطلاع `/kling/tasks` أو رد الاتصال |

## مثال للطلب

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/kling/talking-photo' \
  -H 'authorization: Bearer ${API_KEY}' \
  -H 'content-type: application/json' \
  -d '{
    "image_url": "https://cdn.acedata.cloud/4hfydw.jpg",
    "audio_url": "https://cdn.acedata.cloud/6f7d62b18b.wav",
    "duration": 5
  }'
```

## مثال للاستجابة

```json theme={null}
{
  "success": true,
  "task_id": "0c0b4d3a-2f1e-4a6b-9c2d-2b3c4d5e6f70",
  "video_id": "895055968777281546",
  "video_url": "https://cdn.acedata.cloud/assets/examples/kling/6c68c267-065b-4423-b66b-a0e4c59ee0d5-6a664a591a53.mp4",
  "source_video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4",
  "duration": 5,
  "state": "succeed"
}
```

| الحقل | الوصف |
| - | - |
| `video_url` | الفيديو الناطق النهائي (تم تخزينه على CDN الخاص بمنصتنا) |
| `source_video_url` | فيديو تحريك الصورة الوسيط (نتيجة image2video) |
| `video_id` | معرّف فيديو Kling |

## ملاحظات

* يُنصح بأن تكون الصورة واضحة، بوجه أمامي، ولشخص واحد.
* يُنصح ألا تتجاوز مدة الصوت مدة الفيديو (5 ثوانٍ/10 ثوانٍ).
* تتم الفوترة عند النجاح؛ لا تتم الفوترة عند فشل التحقق من المعلمات (4xx).
* يستغرق الإنشاء حوالي 4–6 دقائق (خطوتان)، ويُنصح باستخدام `async=true` + استطلاع `/kling/tasks`.


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