API 정상 운영 중기능 59개

Beta

개발자 API는 현재 베타 단계이며 언제든 변경될 수 있습니다. 현 단계에서는 개인 테스트와 체험에 더 적합하며, 프로덕션 환경에서의 사용은 아직 권장하지 않습니다.

플레이그라운드

모션 컨트롤

AI로 구동 영상의 모션을 캐릭터 이미지에 전송 - 실시간으로 사실적인 애니메이션을 생성합니다.

POST /api/v1/motion-control/submit → /query

API는 구독 사용자만 이용할 수 있습니다. 웹사이트와 API는 동일한 구독 크레딧 잔액을 공유합니다.

요금제 보기

매개변수

2 개 매개변수

imageUrl*string

필수 요청 매개변수입니다. 표에 표시된 형식과 허용 값을 따르세요.

videoUrl*string

필수 요청 매개변수입니다. 표에 표시된 형식과 허용 값을 따르세요.

API 키API 키는 이 브라우저 탭에서만 사용되며 로컬 저장소에 저장하거나 다른 서비스로 전송하지 않습니다.

요청 코드

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

SUBMIT_RESPONSE="$(curl --fail-with-body --silent --show-error -X POST "https://vidmage.ai/api/v1/motion-control/submit" \
  -H "Authorization: Bearer ${VIDMAGE_API_KEY}" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "imageUrl": "https://vidmage.ai/assets/images/samples/blue-eyed-woman-sunlight.webp",
  "videoUrl": "https://vidmage.ai/assets/models/hailuo-ai-video-generator/skincare-ad.mp4"
}')"
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/motion-control/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/motion-control/submit" \ -H "Authorization: Bearer ${VIDMAGE_API_KEY}" \ -H "Content-Type: application/json" \ --data-raw '{ "imageUrl": "https://vidmage.ai/assets/images/samples/blue-eyed-woman-sunlight.webp", "videoUrl": "https://vidmage.ai/assets/models/hailuo-ai-video-generator/skincare-ad.mp4" }')" 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/motion-control/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