المعلمة
promptمطلوبالنوع
text
القيم
text description
الافتراضي
required
السعر
—
GetVibeAPIالمظهر
اللغة
فيديو
HeyGen Avatar V API — كيفية الاتصال والدفع
HeyGen Avatar V — أحدث محرك للصور الرمزية الناطقة: صورة رمزية جاهزة من HeyGen تنطق بتعليقك الصوتي مع حركة ومزامنة شفاه أكثر طبيعية من Avatar IV. يتطلب avatar (اسم صورة رمزية جاهزة من HeyGen، مثل “Ann Doctor Standing”) وaudio_url؛ وتساوي مدة المقطع مدة الصوت (حتى 5 دقائق). 720p / 1080p / 4K. تُحتسب التكلفة لكل ثانية من الفيديو الناتج.
أنشئ النتيجة التي تحتاج إليها
heygen-avatar-v:flowيعرض هذا النموذج الحد الأدنى لسعره فقط في الكتالوج.
الإدخال: نص, صوتتتطلب بعض الأوضاع إرفاق: heygen avatar (ready-made avatar name), audio track
ما هو HeyGen Avatar V
HeyGen Avatar V — أحدث محرك للصور الرمزية الناطقة: صورة رمزية جاهزة من HeyGen تنطق بتعليقك الصوتي مع حركة ومزامنة شفاه أكثر طبيعية من Avatar IV. يتطلب avatar (اسم صورة رمزية جاهزة من HeyGen، مثل “Ann Doctor Standing”) وaudio_url؛ وتساوي مدة المقطع مدة الصوت (حتى 5 دقائق). 720p / 1080p / 4K. تُحتسب التكلفة لكل ثانية من الفيديو الناتج.
ملخص العقد
- الإدخال
- text, audio
- الإخراج
- video
- الوضع
- غير متزامن (مهمة + استعلام دوري)
- الاستعلام عن الحالة
- كل 3 ثوانٍ · حتى 600 ثانية
نقاط القوة
- التسعير: لكل ثانية
- المدخلات: نص، صوت
- 3 خيارات قابلة للتهيئة
- مفتاح API واحد لتوليد الوسائط
أين يُستخدم
- مقاطع وسائل التواصل الاجتماعي
- العروض الترويجية وتسلسلات العناوين
- تحريك الصور الثابتة
- لوحات القصص والرسوم التحريكية
عقد API
تتم عملية الإنشاء بشكل غير متزامن: أنشئ مهمة، ثم استعلم عن حالتها حتى تكتمل.
- إنشاء مهمة
- POST /api/media/generate
- التحقق من الحالة
- GET /api/media/jobs/{jobId}
- الإدخال
- text, audio
- الإخراج
- video
- الاستعلام الدوري
- كل 3 ثوانٍ · حتى 600 ثانية
- المصادقة
- Authorization: Bearer sk-pv-…
مثال على طلب
مرّر مفتاحك في ترويسة Bearer. تُرجع API jobId للاستعلام عن الحالة.
curl -sS https://getvibeapi.com/api/media/generate \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"heygen-avatar-v:flow","opts":{"avatar":"example","audio_url":"https://example.com/audio_url.mp3","resolution":"720p","aspect_ratio":"auto"}}'JavaScript
const response = await fetch('https://getvibeapi.com/api/media/generate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.GETVIBE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "heygen-avatar-v:flow",
"opts": {
"avatar": "example",
"audio_url": "https://example.com/audio_url.mp3",
"resolution": "720p",
"aspect_ratio": "auto"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);معلمات طلب API
معلمات الطلبات إلى HeyGen Avatar V عبر GetVibe API.
المعلمة
audio_urlالنوع
URL
القيم
Public audio URL
الافتراضي
—
السعر
—
المعلمة
avatarمطلوبالنوع
text / number
القيم
any value
الافتراضي
—
السعر
Included in the base price
المعلمة
resolutionالنوع
option selection
القيم
720p (default) · 1080p · 4K
الافتراضي
720p
السعر
Included in the base price
المعلمة
aspect_ratioالنوع
option selection
القيم
Auto (default) · 16:9 · 9:16 · 4:5 · 5:4 · 1:1
الافتراضي
تلقائي
السعر
Included in the base price
المعلمة
audio_file_idالنوع
text
القيم
Alternative to audio_url: the id of your own file from POST /v1/files (file-pv-…)
الافتراضي
—
السعر
Included in the base price
المعلمة
audio_base64النوع
text
القيم
Alternative to audio_url: the file inline, as base64 or a data: URI
الافتراضي
—
السعر
Included in the base price
| المعلمة | النوع | القيم | الافتراضي | السعر |
|---|---|---|---|---|
promptمطلوب | text | text description | required | — |
audio_url | URL | Public audio URL | — | — |
avatarمطلوب | text / number | any value | — | Included in the base price |
resolution | option selection | 720p (default) · 1080p · 4K | 720p | Included in the base price |
aspect_ratio | option selection | Auto (default) · 16:9 · 9:16 · 4:5 · 5:4 · 1:1 | تلقائي | Included in the base price |
audio_file_id | text | Alternative to audio_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
audio_base64 | text | Alternative to audio_url: the file inline, as base64 or a data: URI | — | Included in the base price |
الطلب: POST https://getvibeapi.com/api/media/generate. الأسعار بالدولار الأمريكي.
سعر HeyGen Avatar V
تكلفة HeyGen Avatar V: من $0.142857 per second. يُحتسب السعر ديناميكيًا وفق سعر الصرف الحالي، وتظهر التكلفة النهائية في استجابة API (priceRub). الدفع بالدولار الأمريكي، دون اشتراكات.
تكلفة الطلب الافتراضي
عند عدم إرسال أي معلمات، يستخدم الطلب هذه القيم: Resolution — 720p, Frame format — Auto. تبلغ تكلفة هذا الطلب $0.142857.
README
يحتوي العقد القابل للقراءة آليًا لـ HeyGen Avatar V على مخطط الطلب، والعمليات، والحدود، وأمثلة الاستطلاع والاستجابة.
# HeyGen Avatar V
نموذج عام: heygen-avatar-v:flow
إنشاء مهمة: POST /api/media/generate
التحقق من الحالة: GET /api/media/jobs/{jobId}
## معلمات الإدخال
- `prompt` (text): text description; افتراضي: required
- `audio_url` (URL): Public audio URL; افتراضي: —
- `avatar` (text / number): any value; افتراضي: —
- `resolution` (option selection): 720p (default) · 1080p · 4K; افتراضي: 720p
- `aspect_ratio` (option selection): Auto (default) · 16:9 · 9:16 · 4:5 · 5:4 · 1:1; افتراضي: Auto
- `audio_file_id` (text): Alternative to audio_url: the id of your own file from POST /v1/files (file-pv-…); افتراضي: —
- `audio_base64` (text): Alternative to audio_url: the file inline, as base64 or a data: URI; افتراضي: —
## الأنواع العامة
- `heygen-avatar-v:flow`: افتراضيالأسئلة الشائعة حول واجهة برمجة تطبيقات HeyGen Avatar V
كم تبلغ تكلفة HeyGen Avatar V؟
سعر HeyGen Avatar V: من $0.142857 per second. يُحتسب السعر ديناميكيًا وفق سعر الصرف الحالي.
هل يتوافق مع OpenAI SDK؟
نعم، واجهة برمجة التطبيقات متوافقة بالكامل مع OpenAI. ما عليك سوى تغيير base_url إلى https://getvibeapi.com/v1 وإضافة مفتاحك — وستبقى بقية الشفرة كما هي.
اربط HeyGen Avatar V الآن
أنشئ حسابًا خلال دقيقة، وادفع حسب الاستخدام، واستفد من الشفرة الجاهزة أعلاه.
الحصول على مفتاح API