Wan 동영상 만들기 - CometAPI Documentation

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=wan3.0 \
  -F 'prompt=A small robot walks through a bright greenhouse with smooth camera movement.' \
  -F seconds=5 \
  -F size=1920x1080

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "wan3.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

텍스트, 참조 미디어 또는 첫 번째와 마지막 프레임으로 Wan 동영상을 만듭니다. 반환된 id을 저장하여 작업을 폴링하고 완성된 동영상을 다운로드하세요. POST /v1/videos multipart/form-data을 사용합니다. 명시적인 정수 seconds 값과 size을 WxH 형식으로 전송하세요.

입력 모드 선택

모든 모드에는 model 및 prompt이 필요합니다. 사용 가능한 미디어 입력은 모델에 따라 다릅니다:

목적	모델 ID	미디어 필드
텍스트-동영상	`wan2.6`, `wan2.7`, `wan3.0`, `wan3.0-prime`	미디어 필드 생략
이미지-동영상	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` URL 또는 업로드된 이미지 파일
참조 동영상	`wan2.6`	`reference_videos` 만
이미지 및 동영상 참조	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` 와 함께 `reference_videos`
이미지, 동영상 및 오디오 참조	`wan3.0`, `wan3.0-prime`	이미지/동영상 참조와 `reference_audios`
첫 번째 및 마지막 프레임	`wan2.7`, `wan3.0`, `wan3.0-prime`	`first_frame`, 선택적으로 `last_frame`

API 키에서 사용할 수 있는 Wan 모델 ID를 찾으려면 다음을 사용하세요 사용 가능한 모델 나열.

참조 이미지 사용

wan2.7, wan3.0, wan3.0-prime의 경우, 공개적으로 액세스할 수 있는 HTTPS URL 또는 업로드된 파일로 input_reference을 통해 참조 이미지를 전송하세요. 이미지가 여러 개인 경우 이미지 순서대로 필드를 반복하고, 각 필드에 URL 또는 파일 하나씩을 지정하세요. input_reference 내에서는 모든 URL 또는 모든 파일을 사용하세요. URL을 쉼표로 구분된 값으로 결합하지 말고 각각 별도로 전송하세요. 각각 최대 20MB의 PNG 또는 JPEG 이미지를 사용하세요. 단일 input_reference URL 또는 파일은 이미지-동영상 워크플로를 사용합니다. 이미지는 구도와 외관을 안내하며, 움직임과 카메라 동작은 프롬프트로 설명하세요. wan3.0 및 wan3.0-prime의 경우, URL이나 업로드된 파일 사용 여부와 관계없이 input_reference을 통해 참조 이미지를 최대 10개까지 전송하세요.

참조 비디오 및 오디오 사용

reference_videos을 통해 비디오를, reference_audios을 통해 오디오 클립을 전송하고 각 입력마다 각 필드를 한 번씩 반복하세요. 각 입력은 공개적으로 액세스할 수 있는 HTTPS URL 또는 업로드된 파일일 수 있습니다. 비디오 참조에는 H.264로 인코딩된 비디오가 포함된 MP4 파일을 사용하세요. 오디오 참조에는 별도의 MP3 파일을 사용하세요. 서로 다른 필드에는 업로드된 비디오와 이미지 URL처럼 서로 다른 입력 유형을 사용할 수 있습니다. reference_videos 또는 reference_audios 내에서는 모두 URL 또는 모두 파일 중 하나를 사용하세요. 각각 최대 50MiB(50 × 1024 × 1024바이트)인 비디오 파일을 최대 5개까지 업로드할 수 있습니다.). 각각 최대 15MiB(15 × 1024 × 1024바이트)인 오디오 파일을 최대 5개까지 업로드할 수 있습니다.).

Wan 2.6 비디오 참조

각각 2~~30초, 최대 30MB, 최소 16fps인 reference_videos을 1~~3개 전송하세요. 이 제한은 URL과 업로드된 비디오 모두에 적용됩니다. 프롬프트에서 입력 순서에 따라 대상을 @Video1, @Video2, @Video3으로 참조하세요. 이 모드에서는 input_reference, reference_audios, first_frame, last_frame을 생략하세요. seconds은 5 또는 10로 설정하세요. 다음 예제에서는 두 개의 비디오 참조로 5초짜리 비디오를 생성합니다. 미디어 URL 또는 파일 이름을 입력으로 바꾸세요:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.6' \
  --form-string 'prompt=Keep @Video1 and @Video2 recognizable as they walk.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'reference_videos=https://your-media-host/reference-1.mp4' \
  -F 'reference_videos=https://your-media-host/reference-2.mp4'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.6' \
  --form-string 'prompt=Keep @Video1 and @Video2 recognizable as they walk.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'reference_videos=@reference-1.mp4;type=video/mp4' \
  -F 'reference_videos=@reference-2.mp4;type=video/mp4'

Wan 2.7 이미지 및 비디오 참조

이미지 및 비디오 참조를 결합하여 대상의 외형과 움직임을 지정하세요. seconds을 2부터 10까지의 정수로 설정하세요. reference_audios은 생략하세요. 비디오 참조와 함께 이미지 URL 두 개 또는 업로드된 이미지 두 개를 사용하세요:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Preserve the image subjects and follow the video motion.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=https://your-image-host/reference-1.png' \
  -F 'input_reference=https://your-image-host/reference-2.jpg' \
  -F 'reference_videos=https://your-media-host/reference.mp4'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Preserve the image subjects and follow the video motion.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=@reference-1.png;type=image/png' \
  -F 'input_reference=@reference-2.jpg;type=image/jpeg' \
  -F 'reference_videos=@reference.mp4;type=video/mp4'

Wan 3.0 이미지, 비디오 및 오디오 참조

wan3.0 및 wan3.0-prime의 경우 이미지 및 비디오 참조를 오디오 참조와 결합하여 외형, 움직임 및 리듬을 지정하세요. 총 길이가 최대 15초인 비디오 참조를 최대 5개까지 전송하세요. 각 비디오는 최소 16fps여야 합니다. 총 길이가 최대 15초인 오디오 참조를 최대 5개까지 전송하세요. 비디오와 오디오 길이는 별도로 계산됩니다. 출력 seconds을 2부터 30까지의 정수로 설정하세요. 비디오 하나 및 오디오 클립 두 개와 함께 이미지 URL 두 개 또는 업로드된 이미지 두 개를 사용하세요:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Preserve image subjects, video motion, and audio rhythm.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=https://your-image-host/reference-1.png' \
  -F 'input_reference=https://your-image-host/reference-2.jpg' \
  -F 'reference_videos=https://your-media-host/reference.mp4' \
  -F 'reference_audios=https://your-media-host/reference-1.mp3' \
  -F 'reference_audios=https://your-media-host/reference-2.mp3'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Preserve image subjects, video motion, and audio rhythm.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=@reference-1.png;type=image/png' \
  -F 'input_reference=@reference-2.jpg;type=image/jpeg' \
  -F 'reference_videos=@reference.mp4;type=video/mp4' \
  -F 'reference_audios=@reference-1.mp3;type=audio/mpeg' \
  -F 'reference_audios=@reference-2.mp3;type=audio/mpeg'

첫 번째 및 마지막 프레임 사용

wan2.7, wan3.0, wan3.0-prime의 경우, 시작 이미지에는 first_frame를 전송하고 종료 이미지에는 선택적으로 last_frame를 전송합니다. 각 필드는 공개적으로 액세스 가능한 HTTPS PNG 또는 JPEG URL 하나 또는 업로드된 PNG 또는 JPEG 파일 하나를 허용합니다. Wan 2.7 프레임 입력의 경우, 시작 이미지가 종횡비를 결정하고 size가 출력 해상도 티어를 선택합니다. input_reference, reference_videos, reference_audios와 별도의 요청으로 프레임 입력을 제출하세요. 다음 Wan 2.7 예에서는 시작 프레임과 종료 프레임 사이의 전환을 생성합니다:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=https://your-image-host/first-frame.png' \
  -F 'last_frame=https://your-image-host/last-frame.jpg'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=@first-frame.png;type=image/png' \
  -F 'last_frame=@last-frame.jpg;type=image/jpeg'

다음 Wan 3.0 예에서는 시작 프레임과 종료 프레임 사이의 전환을 생성합니다:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=https://your-image-host/first-frame.png' \
  -F 'last_frame=https://your-image-host/last-frame.jpg'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=@first-frame.png;type=image/png' \
  -F 'last_frame=@last-frame.jpg;type=image/jpeg'

길이 및 크기 설정

seconds을 모델 및 입력 모드의 허용 범위 내 정수로 전송합니다.

모델 ID	입력 모드	`seconds`	기본값
`wan3.0`, `wan3.0-prime`	텍스트, 참조 또는 프레임	정수 `2`–`30`	`5` 초, `1920x1080`
`wan2.7`	텍스트	정수 `2`–`15`	`5` 초, `1920x1080`
`wan2.7`	프레임	정수 `2`–`15`	`5` 초, `1080p` 티어, 가로세로 비율은 시작 이미지에 따름
`wan2.7`	이미지/비디오 참조	정수 `2`–`10`	`5` 초, `1920x1080`
`wan2.6`	텍스트	`5`, `10`, `15`	`5` 초, `1920x1080`
`wan2.6`	비디오 참조	`5`, `10`	`5` 초, `1920x1080`

대상 모델에 맞게 size를 아래 WxH 값 중 하나로 설정합니다. Wan 3.0 크기 값은 wan3.0-prime에도 적용됩니다.

Wan 3.0 크기 값

해상도 티어	가로세로 비율	`size` (`WxH`)
`480p`	`16:9`	`832x480`
	`9:16`	`480x832`
	`1:1`	`624x624`
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
	`1:1`	`960x960`
	`4:3`	`1088x832`
	`3:4`	`832x1088`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`
	`4:3`	`1632x1248`
	`3:4`	`1248x1632`

Wan 2.7 크기 값

해상도 티어	가로세로 비율	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`

Wan 2.6 크기 값

해상도 티어	가로세로 비율	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
	`4:3`	`1088x832`
	`3:4`	`832x1088`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`
	`4:3`	`1632x1248`
	`3:4`	`1248x1632`

작업 흐름

작업 생성

멀티파트 폼 요청을 전송하고 반환된 id을 저장합니다.

작업 폴링

다음 엔드포인트를 호출하여 Wan 비디오 검색 에서 status가 completed, failed 또는 error 상태가 될 때까지 폴링합니다.

결과 다운로드

작업이 completed 상태가 되면 Wan 비디오 콘텐츠 검색을 호출하여 MP4 파일을 다운로드합니다.

인증

Authorization

string

header

필수

Bearer authentication. Use your CometAPI API key.

본문

multipart/form-data

model

string

필수

Wan model ID: wan2.6, wan2.7, wan3.0, or wan3.0-prime. Use wan2.6 for text or reference-video input. Use wan2.7 for text, image/video references, or frame inputs. Use wan3.0 or wan3.0-prime to also include reference audio.

예시:

"wan3.0"

prompt

string

필수

Text prompt that describes the video to generate. Describe the appearance and motion to preserve from references, or the transition between first_frame and last_frame. For wan2.6 video references, use @Video1, @Video2, and @Video3 in input order.

예시:

"A small robot walks through a bright greenhouse with smooth camera movement."

seconds

integer

Requested output duration in whole seconds. Send an explicit integer. For wan2.6 reference-to-video, use 5 or 10; text-to-video also accepts 15. For wan2.7 reference-to-video, use 2 through 10; text and frame inputs accept 2 through 15. For wan3.0 and wan3.0-prime, use 2 through 30. Default is 5.

필수 범위: 2 <= x <= 30

예시:

5

size

string

Supported WxH size values. For wan3.0 and wan3.0-prime: 832x480, 480x832, 624x624, 640x480, 480x640, 1280x720, 720x1280, 960x960, 1088x832, 832x1088, 1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632. For wan2.6: 1280x720, 720x1280, 1088x832, 832x1088, 1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632. For wan2.7: 1280x720, 720x1280, 1920x1080, 1080x1920, 1440x1440. Default is 1920x1080. For Wan 2.7 frame inputs, the opening image determines the aspect ratio; size selects the output resolution tier.

예시:

"1920x1080"

input_reference

PNG or JPEG reference images for wan2.7, wan3.0, and wan3.0-prime. Repeat input_reference with one publicly accessible HTTPS image URL or uploaded image file per field. Use all URLs or all files within this field. Do not combine URLs into a comma-separated value. A single URL or file uses the image-to-video workflow. Each image can be up to 20 MB. For wan3.0 and wan3.0-prime, send at most 10 reference images, whether you use URLs or uploaded files. Image and video references can share a request; reference audio requires wan3.0 or wan3.0-prime. Submit frame inputs separately. Omit for text-to-video and wan2.6 reference-to-video. Submit images in the order you want to reference them in the prompt.

Pattern: ^https://

reference_videos

(string<uri> | file)[]

Reference videos for wan2.6, wan2.7, wan3.0, and wan3.0-prime. Repeat reference_videos with publicly accessible HTTPS URLs or uploaded MP4 files with H.264 video. Use one input type within this field: all URLs or all files. For wan2.6, send 1 to 3 clips, each 2 to 30 seconds and up to 30 MB, with at least 16 fps; omit image, audio, and frame fields. For wan2.7, combine video references with image references. For wan3.0 and wan3.0-prime, send at most 5 clips totaling at most 15 seconds, with at least 16 fps. Video uploads are limited to 5 files, each at most 50 MiB (50 x 1024 x 1024 bytes); the lower wan2.6 limits still apply. Submit frame inputs separately.

Minimum array length: 1

Pattern: ^https://

reference_audios

(string<uri> | file)[]

Reference audio for wan3.0 and wan3.0-prime, combined with image or video references. Repeat reference_audios with publicly accessible HTTPS MP3 URLs or uploaded MP3 files. Use one input type within this field: all URLs or all files. Send at most 5 audio references totaling at most 15 seconds, counted separately from reference video duration. Audio uploads are limited to 5 files, each at most 15 MiB (15 x 1024 x 1024 bytes). Submit frame inputs separately. Omit for wan2.6 and wan2.7.

Minimum array length: 1

Pattern: ^https://

first_frame

Opening frame for wan2.7, wan3.0, and wan3.0-prime, as one publicly accessible HTTPS PNG or JPEG URL or one uploaded PNG or JPEG file. Use first_frame alone or add last_frame to guide the ending. Submit frame inputs in a separate request from input_reference, reference_videos, and reference_audios. Omit for wan2.6. For Wan 2.7 frame inputs, the opening image determines the aspect ratio; size selects the output resolution tier.

Pattern: ^https://

last_frame

Ending frame for wan2.7, wan3.0, and wan3.0-prime, as one publicly accessible HTTPS PNG or JPEG URL or one uploaded PNG or JPEG file. Use with first_frame to guide the ending. Submit frame inputs in a separate request from input_reference, reference_videos, and reference_audios. Omit for wan2.6. For Wan 2.7 frame inputs, the opening image determines the aspect ratio; size selects the output resolution tier.

Pattern: ^https://

응답

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

string

필수

Task ID. Use this value with retrieve and content endpoints.

예시:

"task_example"

object

string

필수

Object type. Video tasks return video.

예시:

"video"

model

string

필수

Model ID used for the task.

예시:

"wan3.0"

status

enum<string>

필수

Task lifecycle status. Poll until the value is completed, failed, or error.

사용 가능한 옵션:

queued,

in_progress,

completed,

failed,

error

예시:

"queued"

progress

integer

필수

Task progress as a coarse percentage.

필수 범위: 0 <= x <= 100

예시:

0

created_at

integer

필수

Task creation time as a Unix timestamp in seconds.

예시:

1779938152

task_id

string

Compatibility alias for id when present.

예시:

"task_example"

completed_at

integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

예시:

1779938219

video_url

string

Temporary video delivery URL. This field appears on completed tasks.

예시:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

마지막 수정일 2026년 9월 9일

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=wan3.0 \
  -F 'prompt=A small robot walks through a bright greenhouse with smooth camera movement.' \
  -F seconds=5 \
  -F size=1920x1080

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "wan3.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

​입력 모드 선택

​참조 이미지 사용

​참조 비디오 및 오디오 사용

​Wan 2.6 비디오 참조

​Wan 2.7 이미지 및 비디오 참조

​Wan 3.0 이미지, 비디오 및 오디오 참조

​첫 번째 및 마지막 프레임 사용

​길이 및 크기 설정

​Wan 3.0 크기 값

​Wan 2.7 크기 값

​Wan 2.6 크기 값

​작업 흐름

인증

본문

응답

입력 모드 선택

참조 이미지 사용

참조 비디오 및 오디오 사용

Wan 2.6 비디오 참조

Wan 2.7 이미지 및 비디오 참조

Wan 3.0 이미지, 비디오 및 오디오 참조

첫 번째 및 마지막 프레임 사용

길이 및 크기 설정

Wan 3.0 크기 값

Wan 2.7 크기 값

Wan 2.6 크기 값

작업 흐름