Fal.AI를 통해 제공되는 알리바바 Wan 3.0 레퍼런스-비디오 모델입니다. 레퍼런스 이미지 최대 10장, 비디오 클립 최대 5개, 오디오 클립 최대 5개를 프롬프트에서 위치로 인용해(Image 1, Video 1, Audio 1) 캐릭터 정체성·스타일·모션·사운드 단서를 유지한 하나의 비디오로 합성합니다. 480p·720p·1080p, 2~30초, 오디오 생성 옵션을 지원합니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "alibaba/wan-3.0/reference-to-video",
"input": {
"prompt": "The woman in Image 1 walks along a rainy neon-lit street at night, holding the umbrella from Image 2, cinematic tracking shot.",
"reference_image_urls": [
"https://example.com/woman.jpg",
"https://example.com/umbrella.jpg"
],
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "adaptive"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 레퍼런스 미디어를 어떻게 쓸지 지시하는 텍스트 프롬프트. 위치로 인용하세요 (예: 'Image 1의 인물이 Video 1 옆을 지나간다'). 최대 20000자 |
reference_image_urls | array | No | - | 레퍼런스 이미지 URL (캐릭터·사물·스타일). Image 1, Image 2로 인용. 최대 10장 |
reference_video_urls | array | No | - | 레퍼런스 비디오 URL (모션·카메라·장면). Video 1로 인용. 최대 5개, 합산 15초 이하, 각 16fps 이상. 레퍼런스 비디오 길이만큼 출력 길이에 더해 과금됩니다 |
reference_audio_urls | array | No | - | 레퍼런스 오디오 URL (목소리·음악·사운드). Audio 1로 인용. 최대 5개, 합산 15초 이하 |
resolution | string | No | 1080p | 출력 비디오 해상도 480p720p1080p |
aspect_ratio | string | No | adaptive | 출력 화면 비율. 'adaptive'는 모델이 선택합니다 adaptive16:94:31:13:49:16 |
duration | integer | No | 5 | 출력 길이 초 (2~30). 출력 초 + 레퍼런스 비디오 초만큼 과금 |
audio | boolean | No | true | 오디오 생성 포함 여부. 가격은 동일합니다 |
enable_prompt_expansion | boolean | No | true | 프롬프트 자동 리라이팅. 끄면 20~60초 정도 빨라지지만 품질이 떨어질 수 있습니다 |
enable_thinking | boolean | No | false | 생성 전 향상된 추론 사용. file_url 또는 web_url을 주면 자동으로 켜집니다 |
file_url | string | No | - | 비디오의 근거가 될 문서 URL (thinking 자동 활성화) |
web_url | string | No | - | 비디오의 근거가 될 공개 웹페이지 URL. 로그인이 필요한 페이지는 읽을 수 없습니다 (thinking 자동 활성화) |
enable_safety_checker | boolean | No | true | 입력·출력 콘텐츠 검수 활성화 |
seed | integer | No | - | 재현 가능한 생성을 위한 랜덤 시드 (0~2147483647). 생략하면 무작위 |
이 모델의 reference_image_urlsreference_video_urlsreference_audio_urlsfile_url 파라미터에 파일을 전달하는 방법은 3가지입니다.
공개 접근 가능한 URL을 직접 전달합니다. Storage API(POST /v1/files/upload-url)로 업로드하면 파일이 S3로 직접 올라가고(파일당 50MB), 반환된 file_url을 그대로 쓰면 됩니다.
{
"model": "alibaba/wan-3.0/reference-to-video",
"input": {
"prompt": "your prompt here",
"reference_image_urls": ["https://example.com/image.jpg"]
}
}POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 없는 대신, 파일이 API 서버를 거치므로 요청 전체 10MB 제한이 적용됩니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=alibaba/wan-3.0/reference-to-video" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:reference_image_urls=@your_file.png"POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
인물과 소품을 레퍼런스 이미지와 일관되게 유지
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "alibaba/wan-3.0/reference-to-video",
"input": {
"prompt": "The woman in Image 1 walks along a rainy neon-lit street at night, holding the umbrella from Image 2, cinematic tracking shot.",
"reference_image_urls": [
"https://example.com/woman.jpg",
"https://example.com/umbrella.jpg"
],
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "adaptive"
}
}'레퍼런스 클립의 모션과 레퍼런스 오디오의 목소리를 따라가기
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "alibaba/wan-3.0/reference-to-video",
"input": {
"prompt": "The character in Image 1 performs the dance from Video 1 while singing with the voice in Audio 1.",
"reference_image_urls": [
"https://example.com/character.png"
],
"reference_video_urls": [
"https://example.com/dance.mp4"
],
"reference_audio_urls": [
"https://example.com/voice.mp3"
],
"duration": 8,
"resolution": "720p"
}
}'