Wan 3.0 API: 2–30초 AI 영상, 오디오·프레임·레퍼런스
Sume에서 Wan 3.0을 wan-3.0으로 호출하세요. 프롬프트, 첫 프레임과 마지막 프레임, 또는 이미지·영상·오디오 레퍼런스로 480p, 720p, 1080p의 2–30초 클립을 만듭니다.

Wan 3.0은 Sume API의 POST /v1/videos에서 wan-3.0으로 쓸 수 있으며, 480p, 720p, 1080p 해상도로 2초에서 30초 길이의 클립을 만듭니다. 프롬프트만 보내도 되고, 첫 프레임(과 선택적인 마지막 프레임)이나 이미지·영상·오디오 레퍼런스를 보내도 됩니다. 클립과 함께 오디오 트랙도 생성할 수 있습니다.
Wan 3.0의 길이 범위와 레퍼런스 유형은 영상 생성 (영문) 문서에 나와 있고, 나머지 내용은 API가 제공하는 모델 카탈로그에서 가져왔으며 2026-09-26에 확인했습니다. Job 제출과 결과 가져오기는 다른 카탈로그 모델과 똑같이 동작하며, OpenRouter 호환 영상 API에서 볼 수 있습니다.
Sume에서 Wan 3.0으로 무엇을 할 수 있나요?
아래 값은 GET /v1/videos/models가 보고하는 wan-3.0 카탈로그 항목에서 가져왔습니다.
| 기능 | /v1/videos의 Wan 3.0 |
|---|---|
| 입력 | 프롬프트, 첫 프레임과 선택적인 마지막 프레임, 또는 레퍼런스 |
| 길이 | 2–30초, 정수 초 단위 |
| 해상도 | 480p, 720p, 1080p |
| 화면 비율 | 16:9, 4:3, 1:1, 3:4, 9:16 |
| 프레임 유형 | first_frame, last_frame |
| 레퍼런스 유형 | image_url, video_url, audio_url |
| 오디오 | 선택 사항, 끄지 않으면 켜짐 |
| 기존 클립 편집 | 지원하지 않음 |
Wan 3.0 클립은 얼마나 길게 만들 수 있나요?
2초에서 30초까지입니다. duration은 정수이며, 디스크립터의 supported_durations에는 2부터 30까지 모든 정수 초가 나열되어 있습니다. 그 밖의 양의 정수는 제출 시점에 400 unsupported_capability로 거부되며, 오류의 details.supported에 허용되는 목록이 담깁니다. 클립 하나보다 긴 영상은 모델별 AI 영상 길이 한도를 참고하세요.
첫 프레임과 마지막 프레임으로 클립을 만들려면 어떻게 하나요?
first_frame을 담은 frame_images를 보내고, 끝 장면을 고정하려면 last_frame도 넣으세요. first_frame 없이 last_frame만 보내면 거부됩니다. 모델별 프레임 사용은 이미지로 영상 만들기: 첫 프레임과 마지막 프레임에서 다룹니다.
curl -X POST "https://api.sume.com/v1/videos" \
-H "Authorization: Bearer $SUME_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: wan-frames-001" \
-d '{
"model": "wan-3.0",
"prompt": "A hiker walks from the forest edge to the lake shore at sunset",
"frame_images": [
{ "type": "image_url", "image_url": { "url": "https://example.com/first.png" }, "frame_type": "first_frame" },
{ "type": "image_url", "image_url": { "url": "https://example.com/last.png" }, "frame_type": "last_frame" }
],
"resolution": "1080p",
"duration": 12
}'Wan 3.0은 레퍼런스를 몇 개까지 받나요?
레퍼런스로 영상 만들기에는 input_references를 씁니다. Wan 3.0은 이미지뿐 아니라 오디오와 영상 레퍼런스도 반영하며, 한도는 다음과 같습니다.
- 이미지 레퍼런스는 최대 10개입니다.
- 영상 레퍼런스는 최대 5개, 합계 15초이며, 각각 16fps 이상이어야 합니다.
- 오디오 레퍼런스는 최대 5개, 합계 15초입니다.
Wan 3.0은 오디오를 생성하나요?
생성할 수 있으며, 카탈로그는 이 오디오를 선택 사항으로 설명합니다. generate_audio의 기본값은 모델의 오디오 기능을 따르고 Wan 3.0은 이 기능이 켜져 있으므로, generate_audio: false를 보내지 않으면 Sume가 오디오 트랙을 요청합니다.
Sume의 Wan 3.0이 지원하지 않는 것은 무엇인가요?
카탈로그와 /v1/videos 규칙에 나온 미지원 항목은 다음과 같습니다.
- 기존 클립 편집.
16:9,4:3,1:1,3:4,9:16이외의 화면 비율.bitrate_mode.seed와size: 이 필드를 받는 v1 모델은 없으며, 각각400 unsupported_parameter를 반환합니다.file_url/web_url과enable_thinking: v1에서는 제공되지 않습니다.
Wan 3.0 요금은 어떻게 청구되나요?
출력 초당, resolution에 따라 정해지는 요율로 청구됩니다. pricing_skus에는 480p, 720p, 1080p마다 per-video-second-<resolution> 요율이 하나씩 있습니다. 이 SKU의 의미와 기본 5.5% 에이전트 수수료가 어디서 더해지는지는 API로 영상 생성 모델 목록 조회하기에서 설명합니다.
출처
관련 글
작성자 Sume