Wan 3.0 Prime 대 Wan 2.6 Flash: 생성 속도, 프레임 충실도, 비용
대상 모델:
wan3.0-video-prime·wan2.6-flash
추론 엔드포인트:https://api.toapis.com/v1/videos/generations
관련 글: Wan 3.0 Video API 빠른 시작 · Kling Video O1 장편 연속성 · Wan 3.0 레퍼런스 · Wan 2.6 Flash 레퍼런스 · wan3.0-video-prime 모델 가이드 · wan2.6-flash 모델 가이드
1. TL;DR 및 성능 개요
- 먼저 카탈로그를 확인하세요: 기획 초안은 가끔
wan-3-prime과wan-2-6-flash라고 씁니다. 이 문자열은 문서화된 공개 ID가 아닙니다. 2026-11-20에 공식 생성 레퍼런스와 모델 가이드(HTTP 200)를 확인한 결과wan3.0-video-prime과wan2.6-flash가 나와 있었습니다. Prime은wan3.0-video와 같은 Wan 3.0 All-in-One 스키마를 공유하고, Flash는 별도 레퍼런스를 갖습니다. - 같은 게이트웨이, 다른 계약: 두 ID 모두
POST /v1/videos/generations에 제출하고GET /v1/videos/generations/{id}로 폴링합니다. 일반 작업은GET /v1/tasks/{id}로도 조회할 수 있습니다. 공식 예시는https://toapis.com(중국 본토는https://toapis.cn)입니다. 이 시리즈의 다른 가이드는https://api.toapis.com을 사용합니다. 오리진을 하나 정해 일관되게 쓰세요. - 능력의 분기: Prime은 텍스트-투-비디오, 첫·끝 프레임, 멀티모달 참조, 파일 또는 링크, 비디오 편집을 다루며 길이는 2–30초(또는
-1)입니다. Flash는 이미지-투-비디오와 참조 비디오(r2v)만 지원합니다. 프롬프트만 있는 요청은 오류이고 길이는 5, 10, 15초입니다. - 속도와 비용: Flash 페이지는 더 빠른 생성을 서술하고 위안화 초당 표를 공개합니다. 모델 가이드 스냅샷은 Prime을 41.14 credits / 초, Flash를 6 credits / 초로 두었습니다. 공식 페이지는 실측 지연이나 절감률을 공개하지 않습니다.
- 버려야 할 미검증 주장:
$0.014/s, 5초당$0.070, “53% 절감”, “sub-35s”, “약 14초 대 약 36초” 같은 초안 숫자는 현재 ToAPIs 문서가 아닙니다.
2. 문서화된 ID와 능력 비교
model 필드에는 공개 모델 이름을 쓰세요. 초안 별칭, 하이픈 변형, 모드 플래그로 바꾸지 마세요.
| 카탈로그 ID | 이 비교에서의 역할 | 문서화된 작업 |
|---|---|---|
wan3.0-video-prime | Prime / 상위 All-in-One ID | wan3.0-video와 같은 스키마. 텍스트-투-비디오, 첫·끝 프레임, 멀티모달 참조, 파일 또는 링크, 편집과 연장 |
wan3.0-video | 같은 스키마의 표준 Wan 3.0 ID | 표준 All-in-One SKU가 필요하면 Wan 3.0 빠른 시작을 보세요 |
wan2.6-flash | 가속 이미지-투-비디오 및 r2v ID | image_urls 또는 metadata.reference_urls에 따라 i2v-flash 또는 r2v-flash로 라우팅. 텍스트 전용 경로 없음 |
wan2.6 | 관련된 비 Flash Wan 2.6 ID | 텍스트-투-비디오, 이미지-투-비디오, 참조 비디오. 기본으로 오디오를 포함하며 파라미터 맵이 다름 |
라우팅과 충실도에 의미 있는 나란히 비교(지연 표가 아님):
| 항목 | wan3.0-video-prime | wan2.6-flash |
|---|---|---|
| 텍스트-투-비디오 | 예(프롬프트만) | 아니오. 프롬프트만 있는 요청은 오류 |
| 이미지 또는 첫·끝 프레임 | image_with_roles(first_frame, last_frame). 끝 프레임에는 첫 프레임 필요 | image_urls — 1장. metadata.reference_urls와 함께 쓸 수 없음 |
| 참조 비디오 | video_list 최대 5개, 합계 ≤15초. 참조 이미지·오디오와 조합 가능 | metadata.reference_urls가 r2v-flash로 라우팅. image_urls와 함께 쓸 수 없음 |
| 기타 참조 | 참조 오디오, 파일 하나, 또는 웹 링크 하나. 첫·끝 프레임 모드는 이 모두와 배타 | Flash 생성 페이지에는 문서화되지 않음 |
| 길이 | 2–30초, 또는 스마트 길이 -1(기본값 5) | 5, 10, 또는 15초(기본값 5) |
| 해상도 | 480p, 720p, 1080p(기본값 1080p) | 720p 또는 1080p(기본값 1080p). 480p는 없음 |
| 오디오 | 불리언, 기본값 true | 불리언, 기본값 true. 유음과 무음은 다른 요금 |
| 비율 / ratio | ratio(adaptive, 16:9, 9:16, 1:1, 4:3, 3:4). aspect_ratio는 함께 보내지 말 것 | Flash 생성 예시는 wan2.6처럼 종횡비 필드를 문서화하지 않음 |
| 편집 / 연장 | 프롬프트로 분류되는 편집과 연장. 편집에는 ratio=adaptive, duration=-1, 4–30초 소스 필요 | Wan 3.0 스타일 편집 경로로는 문서화되지 않음 |
| 속도 서술 | 턴어라운드 미공개 | 공식 페이지: “더 빠른 생성 속도 — 빠른 미리보기와 반복에 적합” |
두 계약 모두 미디어는 공개 http:// 또는 https:// URL이어야 합니다. base64는 보내지 마세요. Flash는 image_urls에서 base64를 더 이상 지원하지 않는다고 명시합니다.

그림 1: Prime과 Flash는 POST /v1/videos/generations를 공유하지만 문서화된 입력 계열과 길이 구간은 다릅니다. 작업에 맞는 ID를 고른 뒤 같은 작업 id를 폴링하세요.
Prime이 아니라 표준 Wan 3.0 SKU가 필요하면 빠른 시작부터 시작하세요. 비 Flash Wan 2.6 텍스트-투-비디오 경로가 필요하면 wan2.6와 해당 생성 레퍼런스를 사용하세요.
3. 프로덕션 구현: cURL과 Python
이 시리즈의 국제 예시는 https://api.toapis.com을 사용합니다. 공식 문서는 중국 본토 사용자에게 https://toapis.cn을 지정합니다. 환경마다 오리진은 하나만 유지하세요.
1단계: Prime 텍스트-투-비디오와 Flash 이미지-투-비디오를 cURL로 제출
# Prime — text-to-video is documented
curl --request POST \
--url https://api.toapis.com/v1/videos/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "wan3.0-video-prime",
"prompt": "An orange cat running through the streets of Tokyo after rain, cinematic camera work",
"duration": 5,
"ratio": "16:9",
"resolution": "1080p",
"audio": true
}'
# Flash — image_urls or metadata.reference_urls is required
curl --request POST \
--url https://api.toapis.com/v1/videos/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "wan2.6-flash",
"image_urls": ["https://example.com/photo.jpg"],
"prompt": "The person comes alive and smiles",
"resolution": "1080p",
"duration": 5,
"audio": true
}'
2단계: 잘못된 조합을 거부하는 Python 헬퍼
아래 스니펫은 문서화된 작업 상태 경로와 queued / in_progress / completed / failed를 따릅니다. 배포 전에 계정용 API 레퍼런스에서 id, result.data[0].url, 응답 엔벨로프를 확인하세요.
import os
import time
import requests
API_KEY = os.environ["TOAPIS_API_KEY"]
BASE = "https://api.toapis.com"
ENDPOINT = f"{BASE}/v1/videos/generations"
HEADERS = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
}
PRIME_ID = "wan3.0-video-prime"
FLASH_ID = "wan2.6-flash"
def dispatch_compared_model(
model: str,
prompt: str | None = None,
*,
duration: int = 5,
resolution: str = "1080p",
audio: bool = True,
ratio: str | None = None,
image_urls: list[str] | None = None,
reference_urls: list[str] | None = None,
image_with_roles: list[dict] | None = None,
) -> str:
if model not in {PRIME_ID, FLASH_ID}:
raise ValueError("Send wan3.0-video-prime or wan2.6-flash; draft aliases are not documented IDs")
if model == FLASH_ID:
if duration not in {5, 10, 15}:
raise ValueError("wan2.6-flash duration must be 5, 10, or 15")
if resolution not in {"720p", "1080p"}:
raise ValueError("wan2.6-flash resolution must be 720p or 1080p")
if image_urls and reference_urls:
raise ValueError("Flash cannot combine image_urls with metadata.reference_urls")
if not image_urls and not reference_urls:
raise ValueError("wan2.6-flash does not support text-only generation")
if image_urls and len(image_urls) != 1:
raise ValueError("Flash image_urls supports exactly one image")
payload = {
"model": FLASH_ID,
"resolution": resolution,
"duration": duration,
"audio": audio,
}
if prompt:
payload["prompt"] = prompt
if image_urls:
payload["image_urls"] = image_urls
if reference_urls:
payload["metadata"] = {"reference_urls": reference_urls}
else:
if duration != -1 and duration not in range(2, 31):
raise ValueError("Prime duration must be 2–30 or -1")
if resolution not in {"480p", "720p", "1080p"}:
raise ValueError("Prime resolution must be 480p, 720p, or 1080p")
payload = {
"model": PRIME_ID,
"duration": duration,
"resolution": resolution,
"audio": audio,
"ratio": ratio or "16:9",
}
if prompt:
payload["prompt"] = prompt
if image_with_roles:
payload["image_with_roles"] = image_with_roles
res = requests.post(ENDPOINT, headers=HEADERS, json=payload, timeout=30)
res.raise_for_status()
data = res.json()
task_id = data.get("id") or data.get("task_id")
if not task_id:
raise RuntimeError(f"Unexpected submission envelope: {data}")
return task_id
def poll_task(task_id: str, deadline_s: int = 900) -> str:
poll_url = f"{BASE}/v1/videos/generations/{task_id}"
interval = 10.0
start = time.time()
time.sleep(5)
while time.time() - start < deadline_s:
poll = requests.get(poll_url, headers=HEADERS, timeout=15)
if poll.status_code == 429:
retry_after = poll.headers.get("Retry-After")
time.sleep(float(retry_after) if retry_after else min(interval * 2, 120))
continue
poll.raise_for_status()
data = poll.json()
status = data.get("status")
if status == "completed":
return data["result"]["data"][0]["url"]
if status == "failed":
raise RuntimeError(f"Generation failed: {data.get('error')}")
time.sleep(interval)
interval = min(interval * 1.5, 30.0)
raise TimeoutError(f"Task {task_id} exceeded {deadline_s}s; check status before retrying")
if __name__ == "__main__":
flash_id = dispatch_compared_model(
FLASH_ID,
"The person comes alive and smiles",
image_urls=["https://example.com/photo.jpg"],
duration=5,
resolution="720p",
audio=False,
)
print("Flash task:", flash_id)
print("Flash video:", poll_task(flash_id))
이 호출들을 벽시계로 재고 그 결과를 벤더 벤치마크로 공개하지 마세요. 공식 페이지는 그런 기준을 제공하지 않습니다. expires_at 전에 다운로드하세요. 상태 레퍼런스는 30일 보관 기간을 문서화합니다.
4. 오류 처리 및 상태 매트릭스
아래 표는 진단 출발점이며 ToAPIs 오류 코드와 정확히 대응한다고 보장하지 않습니다. HTTP 조회가 성공해도 작업 status를 읽어야 합니다. 요청 오류와 status: failed 사유(content_policy_rejected, insufficient_user_balance, generation_timeout, video_edit_parameters_required 등)는 오류 레퍼런스를 보세요.
| HTTP 또는 작업 상태 | 흔한 범주 | 권장 조치 |
|---|---|---|
400 | Flash 프롬프트 전용 요청, Flash의 image_urls와 reference_urls 병행, Prime의 첫·끝 프레임과 참조 자산 혼용, 또는 문서화되지 않은 길이 | 해당 모델의 문서화된 ID와 배타 필드 계열을 확인 |
401 | API 키 누락 또는 무효 | ToAPIs 대시보드에서 키를 교체하고 Authorization: Bearer 헤더를 확인 |
429 | 속도 또는 동시성 제한 | Retry-After가 있으면 준수. 지터와 함께 백오프. 안전할 때만 재시도 |
5xx 또는 클라이언트 타임아웃 | 게이트웨이 또는 업스트림 일시 문제 | 다시 제출하기 전에 기존 작업 id를 조회. 타임아웃은 속도 벤치마크도, 실패의 증거도 아님 |
status: queued 또는 in_progress | 오류가 아님 | 기다렸다가 다시 폴링. 진행 중인 시간을 공개 SLA로 보지 말 것 |
status: failed | 생성이 성공하지 않음 | error.code와 error.message(있으면 error.reason)를 읽으세요. 정책 거부 페이로드를 그대로 재시도하지 마세요 |
5. 가격 및 FinOps
공식 스냅샷을 인용한 뒤 계정의 실시간 카탈로그를 확인하세요. 초안 산술로 절감률을 만들지 마세요.
Wan 2.6 Flash — 2026-11-20에 가져온 공식 영어 생성 레퍼런스(“Audio vs Silent Pricing”):
| 모드 | 720p 단가 | 1080p 단가 |
|---|---|---|
오디오 켜짐(audio: true) | ¥0.3 / 초 | ¥0.5 / 초 |
무음(audio: false) | ¥0.15 / 초 | ¥0.25 / 초 |
같은 페이지는 해상도가 다르면 가격도 다르다고 하며 모델 마켓플레이스도 참고하라고 합니다. 같은 날 wan2.6-flash 모델 가이드는 가격 참고로 6 credits / 초를 보여 주었고 최종 과금은 현재 계정 견적을 따른다고 밝혔습니다.
Wan 3.0 Prime — Wan 3.0 생성 레퍼런스는 통화 표를 공개하지 않습니다. 2026-11-20 wan3.0-video-prime 모델 가이드는 가격 참고로 41.14 credits / 초를 보여 주었고, 최종 과금은 현재 계정 견적과 현재 길이·해상도 규칙을 따른다고 했습니다. 같은 날 표준 All-in-One ID wan3.0-video는 26.3 credits / 초였습니다. 이 크레딧 수치는 스냅샷이며 모델 가이드 페이지는 해상도별로 나누지 않습니다.
위안화와 크레딧 숫자는 스냅샷으로 보고, 바뀔 수 있습니다. 크레딧을 직접 통화로 환산하지 말고 기획 초안의 USD 단가도 재사용하지 마세요.
- 먼저 작업에 ID를 맞춘 뒤, 같은 작업량에서 비용을 비교하세요. 5초·무음·720p Flash 미리보기는 20초·1080p Prime 텍스트-투-비디오와 같은 SKU가 아닙니다. 카탈로그에서 같은 길이, 해상도, 오디오 설정을 비교하세요.
- Flash 오디오는 문서화된 비용 레버입니다. 공식 표는 720p와 1080p 모두에서
audio가 true일 때 위안화 단가가 무음의 두 배라고 합니다. 이는 계약 진술이지 실측 품질 주장이 아닙니다. - 표시 가격은 채널 보장이 아닙니다. 배치를 예측하기 전에
GET /v1/models?type=video와 실시간 견적으로 두 ID를 확인하세요.
6. 자주 묻는 질문
frontmatter의 FAQ를 보세요. 요약: wan3.0-video-prime과 wan2.6-flash를 보내고 초안 별칭은 보내지 마세요. Flash는 텍스트만 생성을 할 수 없습니다. 길이와 해상도 구간이 다릅니다. 공식 페이지는 Flash를 더 빠르다고 하지만 지연 숫자는 공개하지 않습니다. Flash 위안화 표와 모델 가이드 크레딧 스냅샷을 인용한 뒤 계정 카탈로그에서 확인하세요.
7. 실행 체크리스트
- ToAPIs 개발자 포털에서 키를 만드세요.
-
GET /v1/models?type=video로 키에wan3.0-video-prime과wan2.6-flash가 보이는지 확인하세요.wan-3-prime이나wan-2-6-flash는 보내지 마세요. - Prime은 5초 텍스트-투-비디오로, Flash는 공개
image_urls한 항목으로 스모크 테스트하세요(무음 SKU를 확인하려면 720p와audio: false). - 기한이 있는 상태에서
GET /v1/videos/generations/{id}를 폴링하고expires_at전에 결과를 받으세요. - 다음 단계: All-in-One 파라미터는 Wan 3.0 빠른 시작, 실시간 카탈로그는 Prime과 Flash 모델 가이드. 짧은 문서화 세그먼트를 연결하려면 Kling Video O1 연속성 가이드.







