はじめに
顔が見える画像を image_url に、話し声を audio_url に指定します。Fabric は唇、あご、頭、肩を声に合わせて動かし、音声と同じ長さで画像の縦横比のまま MP4 を返します。
| 項目 | 値 |
|---|---|
| 入力 | 画像 音声 |
| 出力 | 動画 |
| モデル | VEED Fabric 1.0 |
| 必須入力 | 画像( |
| 解像度 | 480p または 720p、縦横比は画像に合わせる |
| 長さ | 音声と同じ、最長 5 分 |
| 課金 | 音声の秒数、端数切り上げ |
主な機能とハイライト
18 世紀の肖像画が 10 秒のセリフを話します
3:4 の油彩肖像画と、録音した女性の声を Fabric に渡しました。唇やあご、首の傾きは言葉に合わせて動き、筆の跡や細かなひび割れ、エメラルドの絹は描かれたままです。720p の結果は 832×1088 でした。
出発点になった静止画
image_url として送った 3:4 の肖像画です。Fabric は色や構図、絵の具の質感をそのまま保ち、話す動きだけを加えました。
演出をつけるのは音声です
録音の間はそのまま画面の間になり、語尾が上がると頭も少し持ち上がります。音声を替えれば、同じ画像でも別の演技になります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | 必須です。顔がはっきり 1 つ写った JPEG、PNG、WebP を指定します。 1 文字以上 |
audio_url | はい | 必須です。MP3、WAV などの話し声で、最長 5 分です。 1 文字以上 |
resolution | いいえ | 480p または 720p です。720p の方が秒単価は高く、どちらも画像の縦横比を保ちます。 |
料金
選んだ解像度の単価で、音声の秒数に応じて課金します。端数は 1 秒単位で切り上げます。画像に料金はかからず、生成に失敗した場合は課金されません。
| 仕様 | 料金 |
|---|---|
| $0.096 / 秒 |
| $0.18 / 秒 |
ユースケース
来訪者にあいさつするキャラクター
ブランドのマスコットやゲームのキャラクター、バーチャル司会者に、3D モデルを作らずに声と動く顔を与えられます。
古い絵や写真が語りかける
絵画や昔の写真、イラストのポスターに一言語らせれば、展示や広告、SNS 投稿の見せ場になります。
一人ひとりに向けた動画メッセージ
同じ肖像のまま音声だけを差し替えて、顧客ごと、言語ごと、キャンペーンごとに動画を量産できます。
プロンプトガイドと実践のヒント
顔がはっきり見える画像を選びます
カメラの方を向き、画面の中である程度の大きさを占める顔ほどきれいに動きます。写真、油彩画、アニメのカット、マスコットのいずれも使えます。
セリフを録音するか生成します
Fabric が話すのは音声で、テキストではありません。声を録音するか音声合成モデルで作り、そのファイルのリンクを
audio_urlに渡してください。解像度を選びます
タイミングの確認は 480p で行い、採用する版を 720p で書き出すと効率的です。どちらも画像の縦横比に従います。
はじめに
VEED Fabric 1.0 は VEED の「画像からトーク動画」モデルです。image_url に肖像、audio_url に話し声を渡し、resolution を選ぶと、同じ顔がその言葉を話す動画が返ります。
主な機能と特長
写真以外も動きます
写真、油彩画、アニメのコマ、マスコットのいずれも動かせます。絵画のテストでは、口元が動いても筆のタッチはそのまま残りました。
長さとリズムは音声が決めます
動画は音声とちょうど同じ長さで、最長 5 分です。録音の間は画面の間になります。
画像の形をそのまま保ちます
縦長の画像からは縦長の動画ができます。3:4 の絵画は 720p で 832×1088、2:3 の写真は 480p で 512×768 でした。
活用シーン
マスコットやバーチャル司会者
ブランドのキャラクターに声を与え、案内動画や新機能の紹介に使えます。
語りかける静止画
歴史的な肖像画やポスターの人物に、展示や広告のセリフを話させられます。
入力のガイドとコツ
顔はカメラ向きに
正面か斜め前を向き、画面の一部を占める顔ほど口の形がきれいに出ます。
話し声はクリアに
音楽のない 1 人の声を使います。雑音が多い録音は、送る前にノイズを除去してください。
試作は 480p で
安い 480p でタイミングを確認し、最終版を 720p で書き出します。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "veed/fabric-1.0/talking-avatar",
"input": {
"audio_url": "https://example.com/reference.mp3",
"image_url": "https://example.com/reference.png",
"resolution": "480p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。




