パラメータ
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個
- メディア生成用の1つの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リクエストパラメータ
GetVibe API経由でHeyGen Avatar Vにリクエストする際のパラメータ。
パラメータ
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。価格はUSDです。
HeyGen Avatar Vの価格
HeyGen Avatar Vの料金: から $0.142857 per second。価格は現在の為替レートに基づいて動的に計算され、最終的な請求額はAPIレスポンス（priceRub）に表示されます。支払いはUSDで、サブスクリプションはありません。
デフォルトのリクエストにかかる料金
パラメーターを指定しない場合、リクエストには次の値が使用されます: 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 APIに関するよくある質問
HeyGen Avatar Vの料金はいくらですか？
HeyGen Avatar Vの料金はから $0.142857 per secondです。料金は現在の為替レートに基づいて動的に計算されます。
OpenAI SDKと互換性がありますか？
はい、APIは完全にOpenAI互換です。base_urlをhttps://getvibeapi.com/v1に変更してキーを設定するだけで、コードの他の部分はそのまま使えます。