Wan과 HappyHorse 시리즈

Alibaba의 동영상 생성 모델로 모두 여섯 가지이며, OfoxAI 동영상 API POST /v1/videos로 호출합니다. 작업은 비동기로 실행됩니다. 작업을 생성하면 작업 ID를 받고, 그 ID로 결과를 조회합니다.

모델 선택

여섯 모델 모두 텍스트-투-비디오와 이미지-투-비디오를 지원하며, 동기화된 오디오 트랙을 생성할 수 있습니다（generate_audio 기본값 true）. adaptive는 입력 이미지의 비율을 그대로 사용한다는 뜻입니다.

위 표는 Models API가 반환하는 video_attributes와 일치합니다. 모델 기능이 조정되면 API 반환값을 기준으로 하십시오. 초 단위로 과금되며 실제 비용은 작업 결과의 usage.video_cost를 기준으로 합니다. 가격은 모델 페이지 를 참고하십시오.

호출 예시

아래 예시는 작업 생성 요청만 보여 줍니다. 생성 후 상태 조회와 결과 다운로드까지의 전체 흐름은 Video API · 빠른 시작을 참고하십시오.

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "이른 아침 중국 강남의 수향 마을, 작은 배가 돌다리 아래를 천천히 지나간다",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "화면 속 인물이 몸을 돌려 먼 곳으로 걸어간다",
    "duration": 5,
    "resolution": "720p",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.7",
    "prompt": "카메라 움직임은 유지하고, 화면을 수묵 애니메이션 스타일로 바꾼다",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }'

• frame_images와 input_references는 함께 전달할 수 없으며, 함께 전달하면 400 references_conflict가 반환됩니다.
• 오디오 트랙이 필요 없으면 "generate_audio": false를 전달합니다.
• 필드 구조의 전체 설명은 동영상 작업 생성을 참고하십시오.

다른 시리즈와의 차이

• 취소 불가: 작업이 업스트림에 제출된 후에는 DELETE /v1/videos/{id}가 400 cancel_not_supported를 반환하며, 작업은 계속 생성되고 요금이 부과됩니다. 제출 전에 파라미터를 확인하십시오.
• 동영상 주소: 실측 결과 작업 완료 후 unsigned_urls（Alibaba Cloud OSS 임시 주소）만 반환되며 mirror_urls는 포함되지 않습니다. 임시 주소는 24시간 후 만료될 수 있으므로 바로 다운로드해 저장하십시오.
• 더 짧은 길이: Wan은 최소 2초, HappyHorse는 최소 3초이며, 다른 시리즈는 최소 4초입니다.

워터마크 제거

Alibaba 계열 모델의 전용 파라미터는 provider.options.dashscope로 전달합니다.

{
  "model": "alibaba/wan-3.0",
  "prompt": "...",
  "duration": 5,
  "resolution": "720p",
  "provider": {
    "options": { "dashscope": { "watermark": false } }
  }
}

provider.options는 매칭된 공급자에게만 전달되며 다른 공급자는 받지 않습니다. 전체 설명은 동영상 공급자 라우팅을 참고하십시오.

자주 발생하는 오류

전체 오류 코드는 Video API 오류 코드를 참고하십시오.

공식 문서

• Alibaba Cloud Model Studio（Bailian）· 모델 서비스 문서 
• OfoxAI · 동영상 작업 생성

자주 묻는 질문