happyhorse-1.1-r2v API

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

샘플 출력happyhorse-1.1-r2vPOST /v1/videos5.2s

매개변수: duration=5resolution=1080pratio=16:9입력 이미지

프롬프트: One continuous take, no cuts. Keep the woman in the crimson satin coat and the peeling carpet ribbons from the reference and move the event outdoors: she walks out of a revolving door onto a wet plaza and the patterned ribbons keep tearing up behind her, now lifting off the paving stones and streaming out across the square in a long coloured wake. The camera tracks backward ahead of her at waist height and cranes up as the wake spreads. One hard green sign light above the door, warm street lamps across the plaza. Real weight and inertia, satin and wet stone, no text.

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

{
  "model": "happyhorse-1.1-r2v",
  "prompt": "One continuous take, no cuts. Keep the woman in the crimson satin coat and the peeling carpet ribbons from the reference and move the event outdoors: she walks out of a revolving door onto a wet plaza and the patterned ribbons keep tearing up behind her, now lifting off the paving stones and streaming out across the square in a long coloured wake. The camera tracks backward ahead of her at waist height and cranes up as the wake spreads. One hard green sign light above the door, warm street lamps across the plaza. Real weight and inertia, satin and wet stone, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9",
  "image": "https://example.com/input-image.png"
}

인증 및 엔드포인트

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": "happyhorse-1.1-r2v",
    "input": {"prompt": "The person in [Image 1] picks up [Image 2].", "media": [{"type": "reference_image", "url": "https://example.com/person.jpg"}, {"type": "reference_image", "url": "https://example.com/object.jpg"}]},
    "parameters": {"resolution": "1080P", "ratio": "16:9", "duration": 5, "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"

요청 메모

HappyHorse는 input.prompt을 사용합니다. t2v, i2v 또는 r2v 모델 ID와 일치하는 input.media 모양을 선택하세요.

요청 매개변수

HappyHorse R2V는 input.media에 1~9개의 reference_image 항목을 배치하고 프롬프트에서 순서대로 참조합니다.

필드	필수	노트
model	예	happyhorse-1.1-r2v
input.prompt	예	텍스트 설명 또는 참조 지침(최대 5,000자 비한자 또는 2,500자)
input.media[]	예	1~9 reference_image 항목; 공개 URL 또는 Base64, 20MB 미만, 최소 400px 짧은 쪽
parameters.resolution	아니요	720P / 1080P, 기본값 1080P
parameters.ratio	아니요	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 4:5 / 5:4 / 9:21 / 21:9, 기본값 16:9
parameters.duration	아니요	3~15초, 기본값 5
parameters.watermark	아니요	HappyHorse 워터마크 추가 여부
parameters.seed	아니요	0부터 2,147,483,647까지의 선택적 시드

입출력 제한

R2V는 1~9개의 reference_image 항목을 사용하며 이를 이미지 1, 이미지 2 등으로 프롬프트 순서대로 참조합니다. 프롬프트는 중국어가 아닌 문자 5,000자 또는 중국어 문자 2,500자로 제한됩니다. 이미지 크기는 20MB 미만이며 최소 짧은 면은 400px입니다.

오류 및 실패한 작업

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

지원 범위

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

가격 및 청구

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

참고

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