빠른 시작
Comfy 워크스페이스에서 키를 생성하고COMFY_API_KEY로 내보내세요. Python과 TypeScript 스니펫은 Comfy SDK(pip install comfy-sdk, npm install @comfyorg/sdk)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행합니다.
모델 ID: wan/wan2.6-t2v
엔드포인트: POST https://api.comfy.org/v2/models/wan/wan2.6-t2v
- Wait for the result
- Queue and collect later
스키마
입력
object
필수
프롬프트 단어 등 기본 정보를 입력합니다.
string
오디오 파일 다운로드 URL입니다. 지원 형식: mp3, wav. reference_video_urls와 함께 사용할 수 없습니다.
string
첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터입니다. I2V 모델에서 필수입니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB.
object[]
wan2.7 및 wan3.0 모델용 미디어 에셋 목록입니다. 비디오 생성을 위한
참조 자료(이미지, 오디오, 비디오)를 지정합니다. 각 요소는 type과 url 필드를 포함합니다.
지원되는 type 값은 모델에 따라 다릅니다:
- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip
- wan2.7-r2v: reference_image, reference_video
- wan2.7-videoedit: video, reference_image
- wan3.0-video: first_frame (최대 1), last_frame (최대 1), reference_image (최대 10), reference_video (최대 5개 클립, 총 재생 시간 <= 15초), reference_audio (최대 5개 클립, 총 재생 시간 <= 15초), file (최대 1, link와 함께 사용할 수 없음), link (최대 1, file과 함께 사용할 수 없음). reference_*/file/link 타입과 first_frame/last_frame 타입은 동일한 요청 내에서 상호 배타적입니다. 배열 순서는 프롬프트에서 에셋의 참조 순서 (Image 1, Video 1, Audio 1, …)를 정의합니다.
string
필수
미디어 에셋 타입가능한 값:
first_frame, last_frame, driving_audio, first_clip, reference_image, reference_video, reference_audio, video, file, linkstring
필수
미디어 파일의 URL (공개 HTTP/HTTPS URL 또는 OSS 임시 URL)
string
네거티브 프롬프트 단어는 비디오 화면에 나타나지 않기를 원하는 콘텐츠를 설명하는 데 사용됩니다.
string
텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며 길이는 800자를 초과할 수
없습니다 (wan3.0-video의 경우 최대 20,000자, 제한을 초과한 콘텐츠는 잘립니다).
참조 비디오가 여러 개인 wan2.6-r2v의 경우 ‘character1’, ‘character2’ 등을 사용하여
참조 비디오 순서대로 대상을 지칭합니다. 예: “Character1 sings on the roadside, Character2 dances beside it”
wan3.0-video 참조 모드의 경우 ‘Image 1’, ‘Video 1’, ‘Audio 1’ 등을 사용하여
media 배열 내 해당 순서의 미디어 에셋을 지칭합니다.
string[]
wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개의 비디오 URL 배열입니다.
입력 제한 사항:
- 형식: mp4, mov
- 개수: 비디오 1-3개
- 단일 비디오 길이: 2-30초
- 단일 파일 크기: 최대 30MB
- audio_url과 함께 사용할 수 없음 참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 비디오 세 개는 그에 비례하여 더 짧습니다. 과금: 실제 사용된 참조 재생 시간을 기준으로 합니다.
string
비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다.
string
호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다. Comfy Router가
POST /v2/models/wan/{model}의 {model} 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략합니다. POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis를 직접 v1 호출하는 경우 반드시 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 WanVideoGenerationRequest에 있습니다.object
비디오 처리 파라미터
boolean
기본값:"true"
비디오에 오디오를 추가할지 여부
string
기본값:"\"auto\""
wan2.7-videoedit 모델용 비디오 오디오 설정입니다.
- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단
-
origin: 입력 비디오의 원본 오디오를 강제로 유지
가능한 값:
auto,origin
integer
기본값:"5"
생성되는 비디오의 재생 시간(초):
- wan2.5 모델: 5초 또는 10초
- wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초
- wan2.6-r2v: 5초 또는 10초만 가능 (15초 미지원)
- wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수
- wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수
-
wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면
입력 비디오 총 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없으며, -1은
모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다
범위:
-1~30
boolean
기본값:"true"
프롬프트 지능형 재작성 활성화 여부입니다. 기본값은 참입니다.
string
생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다.
wan2.7 모델의 경우 제공하지 않으면 해상도 등급에 따라 기본값이 정해집니다.
wan3.0-video의 경우 adaptive(기본값)가 입력 미디어 비율과 의도에 따라 적절한
화면 비율을 자동으로 추천합니다.가능한 값:
adaptive, 16:9, 9:16, 1:1, 4:3, 3:4string
해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다:
- wan2.5-i2v-preview: 480P, 720P, 1080P
- wan2.6-i2v: 720P, 1080P만 가능 (480P 미지원)
- wan2.7 모델 (i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P)
-
wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P)
이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다.
해상도 등급이 과금 요율을 선택하기 때문입니다.
가능한 값:
480P,720P,1080P
integer
난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다범위:
0 ~ 2147483647string
기본값:"\"single\""
지능형 멀티 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다.
wan2.6 및 wan2.7-r2v 모델용입니다.
- single: 단일 샷 비디오 (기본값)
-
multi: 멀티 샷 비디오
사용 가능한 값:
multi,single
string
너비높이 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다:
wan2.5 T2V의 경우: 480P (480832, 832480, 624624), 720P, 1080P 크기
wan2.6 T2V/R2V의 경우 (480P 없음):
720P: 1280720, 7201280, 960960, 1088832, 8321088
1080P: 19201080, 10801920, 14401440, 16321248, 12481632
boolean
기본값:"false"
워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다
GET /v2/models/wan/wan2.6-t2v/openapi.json에서 제공하는 스키마에서 생성되었으며, 요청이 공급자에게 도달하기 이전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다.
출력
object
필수
string
지능형 재작성 이후의 실제 프롬프트 (비디오 작업용)
string
오디오 생성이 포함된 I2V 작업의 오디오 URL
string
실패한 요청의 오류 코드 (요청이 성공하면 반환되지 않음)
string
작업 완료 시간
string
실패한 요청에 대한 상세 정보 (요청이 성공하면 반환되지 않음)
string
원본 입력 프롬프트 (비디오 작업용)
object[]
이미지 생성 작업의 작업 결과 목록
string
지능형 재작성 이후의 실제 프롬프트 (활성화된 경우)
string
이미지 오류 코드 (일부 작업이 실패할 때 반환됨)
string
이미지 오류 정보 (일부 작업이 실패할 때 반환됨)
string
원본 입력 프롬프트
string
생성된 이미지 URL 주소
string
작업 실행 시간
string
작업 제출 시간
string
필수
작업 ID
object
이미지 생성 작업의 작업 결과 통계
integer
실패한 작업 수
integer
성공한 작업 수
integer
전체 작업 수
string
필수
작업 상태가능한 값:
PENDING, RUNNING, SUCCEEDED, FAILED, CANCELED, UNKNOWNstring
완료된 비디오 생성 작업의 비디오 URL. 링크 유효 기간 24시간
string
필수
고유 요청 식별자
object
출력 정보 통계. 성공한 결과만 집계됨
integer
비디오 해상도 등급 (I2V 및 wan3.0-video 작업)
number
생성된 비디오의 재생 시간(초) (I2V 및 wan3.0-video 작업)
integer
생성된 비디오의 프레임 레이트 (wan3.0-video 작업)
integer
생성된 이미지 수 (T2I 및 I2I 작업)
number
입력 비디오의 재생 시간(초), 비디오 입력이 없으면 0.0 (wan3.0-video 작업)
number
출력 비디오의 재생 시간(초) (wan3.0-video 작업)
string
생성된 비디오의 화면 비율, 예: 16:9 (wan3.0-video 작업)
string
이미지 해상도 (T2I 및 I2I 작업)
integer
생성된 비디오 수 (T2V 작업)
number
생성된 비디오의 재생 시간(초) (T2V 작업)
string
비디오 해상도 비율 (T2V 작업)
string
실패한 요청의 오류 코드로,
output 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음).string
실패한 요청에 대한 상세 정보로,
output 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). output.message로 대체하기 전에 이 값을 확인하세요.예시
입력
출력
배포 전 확인
SDK는Idempotency-Key를 생성하고 자동 재시도에서 재사용합니다. 수동 재시도 시에는 원래 키를 재사용하세요. Router는 연결을 최대 10분간 유지할 수 있습니다.
요청이 실패하면 Router는 이유를 설명하는 X-Comfy-Error-Type 응답 헤더를 보냅니다. 422는 Router가 프로바이더를 호출하기 전에 입력을 거부했음을 의미합니다. 생성된 에셋은 결과 URL이 만료될 수 있으므로 즉시 다운로드하세요.
헤더
인증, 멱등성, 요청 ID, 오류 분류, 재시도 간격, 지출 한도.
Router API 사용
모델 검색, 유효성 검사 오류, 재시도, 과금.
제한 사항
Router가 현재 지원하지 않는 기능과 대체 방법.