API beroperasi normal59 kemampuan

Beta

API Developer masih dalam tahap beta dan dapat berubah kapan saja. Saat ini, API ini lebih cocok untuk pengujian dan eksperimen pribadi dan belum direkomendasikan untuk penggunaan produksi.

Playground

Multiple Face Swap Video

Tersedia melalui REST API dan MCP. Tinjau parameter permintaan dan nilai yang diterima di bawah ini.

POST /api/v1/multiple-face-swap-video/submit → /query

Akses API hanya tersedia bagi pelanggan. Kredit langganan digunakan bersama oleh situs web dan API.

Lihat paket

Parameter

2 parameter

targetVideoUrl*string

Parameter permintaan wajib. Ikuti tipe dan nilai yang diterima dalam tabel ini.

faceMappings*object[]

Parameter permintaan wajib. Ikuti tipe dan nilai yang diterima dalam tabel ini.

minItems 1maxItems 4

Kunci APIKunci API hanya digunakan di tab browser ini dan tidak pernah disimpan secara lokal atau dikirim ke layanan lain.

Kode permintaan

#!/usr/bin/env bash
set -euo pipefail

SUBMIT_RESPONSE="$(curl --fail-with-body --silent --show-error -X POST "https://vidmage.ai/api/v1/multiple-face-swap-video/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",
  "faceMappings": [
    {
      "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/multiple-face-swap-video/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

#!/usr/bin/env bash set -euo pipefail SUBMIT_RESPONSE="$(curl --fail-with-body --silent --show-error -X POST "https://vidmage.ai/api/v1/multiple-face-swap-video/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", "faceMappings": [ { "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/multiple-face-swap-video/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