トーキングアバターTalking Avatar について
人物写真1枚と音声1本から、その人がそのセリフを話す動画を作ります。口の形・頭の動き・表情は音声に合わせて動き、動画の長さは音声とぴったり同じです。
POST /jobs/createTask でモデル名に popnow/talking-avatar-v1/talking-avatar を指定すれば呼び出せます。2.7クレジット/秒から（$0.027）。新規アカウントには 30 クレジットが付くので、まず Playground で無料で試せます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
audio_url | はい | 使う声や音楽。 |
image_url | はい | 出発点になる画像。 |
mask_url | いいえ | 変えたい部分を塗ります。 |
prompt | いいえ | Optional note on expression or mood, such as calm or cheerful. Identity and setting come from the portrait. |
seed | いいえ | 同じ数字を使えば、同じ結果を再現できます。 ≥ 0 · ≤ 2147483647 |
料金
料金はクレジットで表示され、サイトで使うクレジットと同じです（1クレジット = $0.01）。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。
| オプション | クレジット /秒 | ≈ USD |
|---|---|---|
| 標準 | 2.7 | $0.027 |
実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。
API クイックスタート
Talking Avatar API を 3 ステップで呼び出す
- API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
- リクエストを送る. POST /jobs/createTask に、model を popnow/talking-avatar-v1/talking-avatar、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
- 結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/talking-avatar-v1/talking-avatar",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"audio_url": "https://media.popnow.ai/shortfilm/voices/Aoede-46e4c427.mp3"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。
Talking Avatar API についての質問
Talking Avatar API の料金はいくらですか？
Talking Avatarは2.7クレジット（$0.027）/秒です。クレジットはサイトと共通（1クレジット = $0.01）で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。
API でのTalking Avatarのモデル名は？
POST /jobs/createTask の model フィールドに トーキングアバターは popnow/talking-avatar-v1/talking-avatar を指定します。
動画はどれくらいの長さにできますか？
音声と同じ長さ、3〜60秒です。長い台本は何本かに分けて録音し、できたクリップを後でつなげてください。
プロンプトは必要ですか？
不要です。口と頭の動きは音声が決めます。短いプロンプトで「落ち着いた」「明るい」など表情の方向を少し寄せられますが、人物と背景は写真から決まります。
写真に複数の人が写っている場合は？
mask_url を渡してください。写真と同じサイズの白黒画像で、話させたい人の部分を白にします。渡さない場合はツールが顔を自動で選ぶため、意図した人にならないことがあります。
Talking Avatar API の制限は？
プロンプトの長さ（文字）：1,000；アップロードの上限：90 MB。この範囲を超えるリクエストは、課金される前に拒否されます。
コードを書かずにTalking Avatarを試せますか？
はい。Playground なら API キーなしで、PopNow のクレジットでTalking Avatarを実行でき、実行ごとに対応するコードが表示されます。
