Wan 비디오 생성
AceDataCloud의 Wan (Alibaba) API를 통해 AI 비디오를 생성합니다.
설정: 토큰 설정은 인증을 참조하세요.
빠른 시작
curl -X POST https://api.acedata.cloud/wan/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "황금 시간대에 파도를 뛰어넘는 돌고래", "model": "wan2.6-t2v"}'
비동기: 비동기 작업 폴링을 참조하세요.
POST /wan/tasks에{"id": "..."}를 사용하여 폴링합니다.
모델
| 모델 | 유형 | 최적 용도 |
|---|---|---|
wan2.6-t2v | 텍스트-투-비디오 | 텍스트 설명으로 비디오 생성 |
wan2.6-i2v | 이미지-투-비디오 | 정지 이미지를 비디오로 애니메이션화 |
wan2.6-r2v | 참조 비디오-투-비디오 | 참조 비디오에서 캐릭터 추출 및 전송 |
wan2.6-i2v-flash | 이미지-투-비디오 (빠름) | 빠른 이미지-투-비디오 생성 |
워크플로우
1. 텍스트-투-비디오
POST /wan/videos
{
"action": "text2video",
"prompt": "초원에서 꽃이 피는 타임랩스",
"model": "wan2.6-t2v",
"resolution": "720P",
"duration": 5
}
2. 이미지-투-비디오
정지 이미지를 비디오 클립으로 애니메이션화합니다.
POST /wan/videos
{
"action": "image2video",
"prompt": "장면을 스치는 부드러운 바람",
"model": "wan2.6-i2v",
"image_url": "https://example.com/landscape.jpg",
"resolution": "720P",
"duration": 5
}
3. 이미지-투-비디오 (Flash)
지연 시간이 줄어든 빠른 이미지-투-비디오 생성.
POST /wan/videos
{
"action": "image2video",
"prompt": "카메라가 풍경을 천천히 패닝합니다",
"model": "wan2.6-i2v-flash",
"image_url": "https://example.com/scene.jpg"
}
4. 참조 비디오 전송
참조 비디오에서 캐릭터 또는 음색을 추출하여 새로운 생성물에 전송합니다.
POST /wan/videos
{
"action": "text2video",
"prompt": "캐릭터가 밤의 미래 도시를 걷는다",
"model": "wan2.6-r2v",
"reference_video_urls": ["https://example.com/reference.mp4"]
}
5. 멀티 컷 편집
단일 연속 촬영 대신 여러 샷으로 구성된 비디오를 생성합니다.
POST /wan/videos
{
"action": "text2video",
"prompt": "바쁜 주방에서 식사를 준비하는 셰프",
"model": "wan2.6-t2v",
"shot_type": "multi",
"duration": 10
}
6. 오디오가 포함된 비디오
비디오와 함께 오디오 생성을 활성화합니다.
POST /wan/videos
{
"action": "text2video",
"prompt": "바위 해안에 부서지는 파도",
"model": "wan2.6-t2v",
"audio": true
}
매개변수
| 매개변수 | 필수 | 값 | 설명 |
|---|---|---|---|
action | 예 | "text2video", "image2video" | 작업 유형 |
prompt | 예 | 문자열 | 장면 설명 |
model | 예 | "wan2.6-t2v", "wan2.6-i2v", "wan2.6-r2v", "wan2.6-i2v-flash" | 모델 |
image_url | image2video의 경우 | 문자열 | 소스 이미지 URL (이미지-투-비디오에 필요) |
negative_prompt | 아니오 | 문자열 (최대 500자) | 생성에서 제외할 내용 |
reference_video_urls | r2v의 경우 | 문자열 배열 | 캐릭터/음색 추출을 위한 참조 비디오 |
shot_type | 아니오 | "single", "multi" | 연속 촬영 또는 멀티 컷 편집 |
audio | 아니오 | 부울 | 생성된 비디오에서 오디오 활성화 |
audio_url | 아니오 | 문자열 | 참조 오디오 URL |
resolution | 아니오 | "480P", "720P", "1080P" | 출력 해상도 (기본값: 720P) |
size | 아니오 | 문자열 | 생성된 비디오의 크기 |
duration | 아니오 | 5, 10, 15 | 비디오 길이 (초) |
prompt_extend | 아니오 | 부울 | LLM 기반 프롬프트 재작성 활성화 |
callback_url | 아니오 | 문자열 | 비동기 웹훅 알림 URL |
주의사항
image_url은wan2.6-i2v및wan2.6-i2v-flash모델에 필수입니다.reference_video_urls는 캐릭터/음색 전송을 위해wan2.6-r2v에서만 사용됩니다.negative_prompt는 최대 길이가 500자입니다.- 지원되는 지속 시간은 5, 10 또는 15초입니다.
- 기본 해상도는 720P입니다. 더 높은 품질을 원하면 1080P를 사용하지만 비용이 증가합니다.
shot_type: "multi"는 단일 연속 샷 대신 멀티 컷 편집을 생성합니다.
MCP:
pip install mcp-wan| 호스팅:https://wan.mcp.acedata.cloud/mcp| 모든 MCP 서버 참조