wan2.7-r2v API

정확한 모델 ID wan2.7-r2v를 사용하세요. 모델 필드는 이 페이지와 정확히 일치해야 합니다.

샘플 출력wan2.7-r2vPOST /v1/videos5.0s

매개변수: duration=5resolution=1080Pratio=16:9참고 이미지

프롬프트: One continuous take, no cuts. Keep the glass flowers from the reference exactly as they are and carry them into a new place: a wide city crossing at night in the rain. The whole bed of glass blooms now grows straight out of the wet asphalt across the junction, ringing as the rain strikes them, headlights firing caustics along the road. The camera starts at kerb height among the stems, moves forward through them and rises to look down the length of the crossing. One hard pink key from a shopfront on the left, cold blue signals behind. Real weight and inertia, glass and water, no text.

입력 미디어 URL을 대체하여 이 샘플을 생성한 요청

{
  "model": "wan2.7-r2v",
  "input": {
    "prompt": "One continuous take, no cuts. Keep the glass flowers from the reference exactly as they are and carry them into a new place: a wide city crossing at night in the rain. The whole bed of glass blooms now grows straight out of the wet asphalt across the junction, ringing as the rain strikes them, headlights firing caustics along the road. The camera starts at kerb height among the stems, moves forward through them and rises to look down the length of the crossing. One hard pink key from a shopfront on the left, cold blue signals behind. Real weight and inertia, glass and water, no text.",
    "media": [
      {
        "type": "reference_image",
        "url": "https://example.com/input-image.png"
      }
    ]
  },
  "parameters": {
    "duration": 5,
    "resolution": "1080P",
    "ratio": "16:9"
  }
}

인증 및 엔드포인트

https://modelflare.dev/v1과 함께 Modelflare API 키를 사용합니다. 게이트웨이 진입점은 POST /v1/videos입니다.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

작업 생성

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-r2v",
    "input": {"prompt": "The subject in Image 1 walks through the street from Video 1.", "media": [{"type": "reference_image", "url": "https://example.com/reference.png"}, {"type": "reference_video", "url": "https://example.com/reference.mp4"}]},
    "parameters": {"resolution": "1080P", "ratio": "16:9", "duration": 5, "prompt_extend": false, "watermark": false}
  }'

폴링 및 다운로드

작업 ID를 저장합니다. GET /v1/videos/{task_id}을 폴링하고 GET /v1/videos/{task_id}/content로 다운로드합니다. 결과 URL은 만료될 수 있으므로 즉시 파일을 전송하세요.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

요청 메모

Wan은 일반적으로 input 및 parameters을 사용합니다. 프레임 가이드 모드와 참조 미디어 모드를 혼합하면 안 됩니다.

요청 매개변수

Wan2.7 R2V는 reference_image / reference_video 미디어를 사용하며 reference_voice를 부착할 수 있습니다. 이 워크플로우를 first_frame / last_frame 역할과 혼합하지 마십시오.

필드	필수	노트
model	예	wan2.7-r2v
input.prompt	예	문서화된 구문을 사용하여 장면과 참조 미디어를 설명합니다.
input.media[]	예	최소 하나의 reference_image 또는 reference_video
input.media[].reference_voice	아니요	음성 특성에 대한 공개 WAV/MP3 URL
parameters.resolution	아니요	720P / 1080P (기본값 1080P)
parameters.ratio	아니요	16:9 / 9:16 / 1:1 / 4:3 / 3:4 (first_frame가 있는 경우 무시됨)
parameters.duration	아니요	참조 동영상이 있는 경우 더 짧은 재생 시간 제한을 사용합니다.
parameters.prompt_extend	아니요	이 전용 모델 계약에서 요구하는 경우 false로 설정합니다.
parameters.watermark	아니요	워터마크 추가 여부
parameters.seed	아니요	선택적 무작위 시드

입출력 제한

R2V에는 하나 이상의 reference_image 또는 reference_video이 필요하며 최대 5개의 참조 이미지/비디오가 결합되어 있습니다. first_frame 하나와 reference_voice 하나를 부착할 수 있습니다. 참조 동영상이 있으면 재생 시간 제한이 더 짧아집니다.

문서화된 워크플로우 예시

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-r2v",
    "input": {"prompt": "让图像主体沿视频动作自然移动", "media": [
      {"type": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "url": "https://example.com/motion.mp4"}
    ]},
    "parameters": {"resolution": "1080P", "duration": 8, "prompt_extend": false}
  }'

오류 및 실패한 작업

잘못된 모델 매개변수는 요청 ID와 함께 4xx를 반환합니다. 비동기 작업은 생성이 성공한 후 실패 상태로 들어갈 수도 있습니다. 최종 작업 사유로 폴 응답의 error_code 및 error_message을 사용합니다. 다른 JSON 형태로 동일한 요청을 재시도하지 마세요.

지원 범위

이 페이지에서는 Modelflare 모델 생성 및 편집 호출을 다룹니다. 검색 또는 지도 강화, 음성 관리 및 요소 라이브러리 관리는 이 공개 모델 호출 표면 외부의 리소스 API이며 필수 요청 필드가 아닙니다.

가격 및 청구

이 모델은 초당 비디오 과금을 사용합니다. 현재 고객 가격, 참조 정가 및 전체 사양은 모델 가격 페이지를 참조하세요.

참고

이 페이지는 Modelflare의 공개 인터페이스를 문서화합니다. 여기에 표시된 필드와 한도는 현재 계약입니다.

변형

모델 ID	차이점
wan2.7-r2v	이 페이지에 문서화된 모델입니다.