Wan 2.6 Flash 이미지 투 비디오 API 사용법은? 화면 비율은 이미지를 따라감

TL;DR

• Wan 2.6 Flash Image to Video(wan2.6-flash/image-to-video)는 이미지 1장을 업로드하고 동작 설명 한 문장을 작성하면 5초, 10초 또는 15초의 720p / 1080p 영상을 생성하며, 필요에 따라 동기 오디오를 켤 수 있습니다; 출력 화면 비율은 입력 이미지를 따릅니다, 세로 이미지는 바로 세로 화면으로 나옵니다. 모델 페이지 열기에서 바로 시도해 볼 수 있고, 신규 사용자 가입 시 200 크레딧을 드립니다.
• 가격은 초 단위로 계산되며 네 가지 조합: 720p 무음(기본) 초당 $0.029, 오디오 켜면 $0.0575, 1080p 무음 $0.043, 오디오 켜면 $0.086 (전체 가격은 가격 페이지 참조).
• 호출은 HiAPI /v1/tasks 인터페이스를 사용합니다: image_urls는 정확히 1장의 이미지, 성공 후 output에서 영상 주소를 가져옵니다(임시 주소이므로 즉시 저장).

할 수 있는 일

• 이미지 한 장 + 문장 한 개 = 동작 한 편: 화면 주체와 조명은 원본 이미지를 유지하고, 모델은 원하는 동적 요소, 카메라, 분위기만 추가합니다.
• 세 가지 길이: 5 / 10 / 15초, 기본 5초.
• 화면 비율은 이미지를 따라감: 화면 비율 파라미터가 없습니다 — 가로 이미지는 16:9, 세로 이미지는 세로 화면, 3:4 이미지는 3:4로 나오므로 소셜 미디어 소재를 다시 자를 필요가 없습니다.
• 오디오는 필요 시 켜기: audio는 기본 꺼짐; 켜면 소리가 화면과 동기화되어 생성됩니다(뒤집개 소리, 불꽃 소리 같은 환경음).

아래는 실제 완성 영상입니다(기본 파라미터: 720p, 5초, 무음):

The fox turns its head toward the camera, its ears twitch, golden leaves drift down through the misty light

(중국어 의미: 여우가 고개를 돌려 카메라를 바라보고, 귀가 살짝 떨리며, 금빛 낙엽이 옅은 안개 빛 속에서 흩날린다. 여우 사진을 첫 프레임으로 업로드; 프롬프트는 중국어도 지원하며 최대 1500자입니다.)

·

wan2.6-flash/image-to-video, 720p, 5초, 16:9, 1280×720, 무음, $0.145.전체 영상 보기 →

이 프롬프트로 생성하기 →

가격: 네 가지 조합 한 표

등급	초당	5초	10초	15초
720p 무음(기본)	$0.029	$0.145	$0.29	$0.435
720P · 오디오 켜기	$0.0575	$0.2875	$0.575	$0.8625
1080P · 무음	$0.043	$0.215	$0.43	$0.645
1080P · 오디오 켜기	$0.086	$0.43	$0.86	$1.29

HiAPI 현재 가격, 2026년 10월 22일 확인. 기본 등급을 1로 볼 때: 오디오 켜면 약 2배, 1080p로 올리면 약 1.5배, 올리고 켜면 약 3배. 실패 시 요금이 부과되지 않습니다.

두 가지 시작 경로

브라우저 3단계: 모델 페이지 열기 → 이미지 업로드, 동작 설명 작성 → 생성 클릭, 기본 등급 5초 $0.145, 영상이 나오면 페이지에서 바로 미리 보고, 만족하면 코드를 작성해 인터페이스를 자체 비즈니스 프로세스에 연결하세요.

API 3단계: POST /v1/tasks 제출 → taskId 획득 → GET /v1/tasks/<taskId>로 success 확인 후 다운로드.

curl: 첫 번째

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: your-unique-key-001" \
  -d '{
  "model": "wan2.6-flash/image-to-video",
  "input": {
    "prompt": "The fox turns its head toward the camera, its ears twitch, golden leaves drift down through the misty light",
    "image_urls": ["https://static.hiapi.ai/gallery/2026/10/ced2dd4214889094.jpg"],
    "duration": 5,
    "resolution": "720p",
    "audio": false
  }
}'

이 요청은 현재 가격 기준 720p 무음 × 5초 = $0.145입니다.

Python: 제출, 폴링, 다운로드

import time, uuid, requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "model": "wan2.6-flash/image-to-video",
    "input": {
        "prompt": "The fox turns its head toward the camera, its ears twitch, golden leaves drift down through the misty light",
        "image_urls": ["https://example.com/your-image.jpg"],
        "duration": 5,
        "resolution": "720p",
        "audio": False,
    },
}

resp = requests.post(
    BASE,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json=payload,
    timeout=30,
)
resp.raise_for_status()
task_id = resp.json()["taskId"]

while True:
    task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()
    print(task["status"])
    if task["status"] in ("success", "fail"):
        break
    time.sleep(5)

if task["status"] == "success":
    video = next(o for o in task["output"] if o.get("type") == "video")
    mp4 = requests.get(video["url"], timeout=120)   # 임시 주소이므로 가능한 한 빨리 저장
    with open("output.mp4", "wb") as f:
        f.write(mp4.content)
    print("saved output.mp4")

파라미터 표

필드	필수	값	설명
image_urls	예	정확히 1장	JPG / PNG / WebP, ≥256×256, ≤10MB; 화면 비율이 출력 화면 비율을 결정
prompt	예	1–1500자	동작, 카메라, 분위기를 설명; 중국어와 영어 모두 가능
duration	아니요	5 / 10 / 15, 기본 5	이 세 가지뿐
resolution	아니요	720p / 1080p, 기본 720p
audio	아니요	기본 false	동기 오디오, 별도 가격(가격 표 참조)

요청 본문에 표에 없는 필드가 있으면 바로 400이 발생합니다.

만나게 될 오류

상태 코드	의미	처리 방법
400 INVALID_REQUEST	요청 본문이 유효하지 않음(image_urls 또는 prompt 누락, 이미지 2장 전달, duration에 7 전달)	파라미터 표에 맞춰 요청 본문 수정
402 INSUFFICIENT_QUOTA	잔액 부족(요금 미부과)	충전 후 재시도
429 RATE_LIMITED	속도 제한 초과	제출 빈도 낮추기
409 / 422 IDEMPOTENCY_KEY_*	동일한 멱등 키로 중복 제출	새 Idempotency-Key로 변경

작업 최종 상태 실패에는 CONTENT_POLICY_VIOLATION, TASK_FAILED, TASK_TIMEOUT 등이 있으며; 실패 시 요금이 부과되지 않습니다.

배포 전 주의사항

• 콜백: 요청 본문 최상위에 "callback": {"url": "https://..."}를 전달하면 최종 상태를 자동으로 알려줍니다.
• 즉시 전송: output의 영상 주소는 임시이므로 받은 즉시 다운로드하세요.
• 이미지 품질이 상한: 최소 256×256, 최대 10MB; 선명하고 큰 이미지가 선명한 영상을 만듭니다.
• 세로 소재는 세로 이미지 업로드: 화면 비율 파라미터가 없으므로 9:16을 원하면 세로 이미지를 업로드하세요.

자주 묻는 질문

화면 비율이 입력 이미지를 따르나요?

따릅니다. 가로 이미지는 가로 화면, 세로 이미지는 세로 화면, 3:4 이미지는 3:4 — 비율 파라미터를 전달할 필요가 없습니다.

오디오는 어떻게 켜나요?

명시적으로 audio: true를 전달해야 소리가 있으며, 가격은 Sound On 등급(약 2배)으로 계산됩니다.

길이에 임의의 초 수를 전달할 수 있나요?

아니요. 5 / 10 / 15초 세 가지뿐이며, 다른 초 수를 전달하면 400이 발생합니다.

프롬프트에 중국어를 쓸 수 있나요?

가능합니다. 중국어와 영어 모두 가능하며 최대 1500자; 동작과 카메라를 작성하고 화면 설명을 반복할 필요는 없습니다. 과금은 해상도, 길이, 오디오 스위치만 봅니다.

$10으로 몇 개를 만들 수 있나요?

기본 등급(720p 무음 5초) 한 개 $0.145, $10으로 약 68개.

다음 단계: 제품 이미지나 사진 한 장을 가지고 모델 페이지에서 움직이게 하고, 네 가지 시나리오 템플릿은 프롬프트 모음을 참고하세요.