모델 API 페이지
Wan Animate Replace API 연동
Rivya Public API v1에서 Wan Animate Replace을 모델 ID wan-2-2-animate-replace, 지원 입력, 파라미터, Files API 규칙, 크레딧, 응답 예시와 함께 사용하세요.
API로 사용 가능URL 입력 준비됨비디오
API 모델 ID
wan-2-2-animate-replace
입력
url
Files API
최소 요청에는 필요 없음
기본 크레딧
20
기능
비디오
과금
FIXED
프롬프트 제한
문서화된 프롬프트 제한 없음
요청 계약
모델 ID는 최상위 수준에 보냅니다. 모델별 제어값은 params에 넣습니다.
| Key | 유형 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
| model | string | 예 | wan-2-2-animate-replace | wan-2-2-animate-replace을 API 모델 ID로 사용합니다. |
| prompt | string | 아니요 | - | 텍스트 입력을 지원하는 모델에 보내는 프롬프트 텍스트입니다. |
| params | object | 아니요 | - | 모델별 파라미터 객체입니다. 허용되는 키는 아래 행을 확인하세요. |
| client_request_id | string | 아니요 | - | 자체 시스템에서 요청을 추적하기 위한 선택적 클라이언트 ID입니다. |
모델 파라미터
| Key | 유형 | 필수 | 기본값 | 범위 | 옵션 | 설명 |
|---|---|---|---|---|---|---|
| video_url | text | 아니요 | - | - | - | 생성 서비스가 직접 가져올 수 있는 공개 비디오 URL을 붙여넣으세요. 이 모델은 로컬 업로드 경로가 아니라 MP4, MOV, MKV 같은 호스팅된 자산을 기대합니다. |
| image_url | text | 아니요 | - | - | - | 공개 교체 이미지 URL을 붙여넣으세요. JPEG, PNG, WebP가 가장 잘 작동합니다. 화면비가 다르면 업스트림 서비스가 스케일링하고 중앙 크롭합니다. |
| resolution | select | 아니요 | 480p | - | 480p, 580p, 720p | 현재 구간은 `480p`, `580p`, `720p`입니다. 더 높은 출력 구간은 보통 더 높은 크레딧 비용과 더 긴 대기 시간을 의미합니다. |
최소 요청
{
"model": "wan-2-2-animate-replace",
"params": {
"video_url": "https://example.com/input.mp4",
"image_url": "https://example.com/reference.png",
"resolution": "480p"
}
}생성 응답
생성 엔드포인트는 공개 작업 ID를 반환합니다. 작업이 성공하거나 실패할 때까지 상태 엔드포인트를 폴링하세요.
{
"id": "task_wan_2_2_animate_replace_example",
"status": "queued",
"model": "wan-2-2-animate-replace",
"reserved_credits": 20,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}일반 오류
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
이 모델은 모델 파라미터를 통해 공개 URL 입력을 받습니다.