Skip to main content
POST
cURL
استخدم نقطة النهاية هذه لإنشاء مقاطع أفاتار ناطقة من صورة مصدر واحدة بالإضافة إلى مصدر صوت واحد.

قبل استدعائها

  • وفّر image واحدة للأفاتار كرابط URL عام أو كسلسلة base64 خام
  • استخدم صورة أفاتار تستوفي متطلبات البكسل الخاصة بـ Kling؛ إذ ترفض مهمة الإنشاء الصور المصغّرة الصغيرة جدًا
  • أرسل واحدًا فقط من audio_id أو sound_file
  • اجعل الطلب الأول بسيطًا: صورة وجه واحدة، ومقطع صوتي واحد، وPrompt اختياري قصير
  • ضمّن task_id عندما يكون الصوت المشار إليه تابعًا لمهمة سابقة يجب ربطها
  • ابدأ بـ mode: std ما لم تكن تحتاج تحديدًا إلى المسار الأعلى جودة

قواعد مصدر الصوت

  • يُعد audio_id المسار الأسهل عندما تكون قد أنشأت الكلام بالفعل عبر مسار Kling TTS
  • يعمل sound_file عندما يكون لديك بالفعل ملف MP3 أو WAV أو M4A أو AAC خاص بك
  • تم توثيق أن مدة صوت الأفاتار تتراوح من 2 إلى 60 ثانية

تدفق المهمة

1

إنشاء مهمة الأفاتار

أرسل الصورة ومصدرًا صوتيًا واحدًا، ثم احفظ task id المُعاد.
2

الاستعلام عن المهمة

تابع باستخدام الحصول على مهمة Kling حتى تصل المهمة إلى حالة نهائية.
3

تخزين النتيجة النهائية

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

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الترويسات

Content-Type
string

Optional content type header.

الجسم

application/json
image
string
مطلوب

Avatar image URL or base64 image string. Use an image that meets Kling pixel requirements; very small thumbnails are rejected.

prompt
string
مطلوب

Prompt describing the desired avatar performance.

audio_id
string
مطلوب

Audio id from a prior Kling audio task.

sound_file
string

Public audio URL when you provide your own audio.

task_id
string

Optional prior task id associated with the referenced audio asset.

mode
enum<string>

Generation mode. Use std or pro; omitted requests use std.

الخيارات المتاحة:
std,
pro

الاستجابة

200 - application/json

Task accepted.

code
integer
مطلوب
message
string
مطلوب
data
object
مطلوب