開発者 API は現在もベータ段階であり、いつでも変更される可能性があります。現段階では個人でのテストや試用に適しており、本番環境での使用はまだ推奨していません。
プレイグラウンド
対象動画で追跡された顔を、参照画像の顔に置き換えます。顔検出、ランドマーク追跡、結果解析は自動で行われます。
POST /api/v1/video-face-swap/submit → /queryAPI はサブスクリプション契約者のみ利用できます。Web サイトと API では同じクレジット残高が使用されます。
料金プランを見る置き換えに使用する顔を含む、外部からアクセス可能な参照画像の URL。
置き換える追跡対象顔の 0 始まりのインデックス。
参照画像から使用する顔の 0 始まりのインデックス。
#!/usr/bin/env bash
set -euo pipefail
SUBMIT_RESPONSE="$(curl --fail-with-body --silent --show-error -X POST "https://vidmage.ai/api/v1/video-face-swap/submit" \
-H "Authorization: Bearer ${VIDMAGE_API_KEY}" \
-H "Content-Type: application/json" \
--data-raw '{
"targetVideoUrl": "https://vidmage.ai/assets/models/hailuo-ai-video-generator/skincare-ad.mp4",
"referenceFaceImageUrl": "https://vidmage.ai/assets/images/samples/smiling-man-sweater.webp"
}')"
TASK_ID="$(printf '%s' "$SUBMIT_RESPONSE" | jq -er '.["taskId"]')"
while true; do
QUERY_RESPONSE="$(curl --fail-with-body --silent --show-error -X POST "https://vidmage.ai/api/v1/video-face-swap/query" \
-H "Authorization: Bearer ${VIDMAGE_API_KEY}" \
-H "Content-Type: application/json" \
--data-raw "{\"taskId\":\"${TASK_ID}\"}")"
STATUS="$(printf '%s' "$QUERY_RESPONSE" | jq -r '(.status // .data.status // "") | ascii_downcase')"
case "$STATUS" in
success|succeeded|completed)
printf '%s' "$QUERY_RESPONSE" | jq -r '(.result // .["videoUrl"] // .data["videoUrl"] // empty)'
break
;;
failed|error)
printf '%s' "$QUERY_RESPONSE" | jq -r '(.message // .error // .data.error // "Task failed")' >&2
exit 1
;;
esac
sleep 5
done