문서에서 비디오 생성 API: PDF, PPT, XLS, DOCX, 웹페이지

Wan 3.0은 하나의 PDF, PPT/PPTX, XLS/XLSX, DOC/DOCX, 텍스트 또는 마크다운 파일, 또는 하나의 공개 웹페이지를 참고자료로 하여 2~30초 분량의 비디오를 생성할 수 있습니다. 문서 제한은 100MB, 50페이지입니다. 이는 개념 비디오와 요약에 유용하지만 생성 해석이며, 픽셀 정확도의 PowerPoint 내보내기가 아닙니다.^[1]

마지막 구분이 많은 잘못된 기대감을 덜어줍니다. 모든 슬라이드, 차트 레이블, 문장을 정확히 재현해야 한다면 직접 렌더링하세요. 소스 자료를 읽고 짧은 시각적 처리로 바꾸는 모델이 필요하다면 문서-비디오가 적합한 작업입니다.

지원되는 문서 및 링크 입력

현재 Wan 3.0 API는 다음 중 하나를 허용합니다:

입력	지원 형식	제한
Office 문서	DOCX, DOC, XLSX, XLS, PPTX, PPT	100MB, 50페이지
PDF/텍스트	PDF, TXT, MD	100MB, 해당 시 50페이지
Apple iWork	Keynote, Pages, Numbers	100MB, 50페이지
웹페이지	공개 로그인 불필요 URL	하나의 URL

문서는 file_url, 웹페이지는 link_url을 사용하세요. 둘은 상호 배타적입니다. 둘 다 전송하면 생성 전에 거부됩니다.^[1]

URL은 공개 HTTP(S) 링크여야 합니다. /Users/me/report.pdf와 같은 경로, 비공개 Google Drive 링크, 로그인 뒤의 페이지는 모델에서 가져올 수 없습니다.

최소 PDF-비디오 요청

먼저 문서를 스토리지에 업로드한 후 그 URL을 제출합니다:

curl -X POST https://api.reapi.ai/api/v1/videos/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "file_url": "https://files.example.com/q3-product-brief.pdf",
    "prompt": "Create a 20-second product launch concept. Keep the three claims and the product color from the brief. Use four clear scenes and restrained on-screen text.",
    "resolution": "720P",
    "duration": 20,
    "audio": true
  }'

응답은 비동기이며 작업 ID를 포함합니다. 상태가 completed일 때까지 GET /api/v1/tasks/{id}를 폴링합니다. MP4는 output.video_urls에 나타납니다.^[1]

현재 720P 요율인 초당 $0.076으로 20초 요청은 $1.52입니다. 문서 크기는 두 번째 청구 단위를 추가하지 않습니다. 해상도와 출력 기간이 공개 요율을 결정합니다.^[2]

웹페이지-비디오는 같은 모델을 사용합니다

file_url을 link_url로 바꿉니다:

{
  "model": "wan3.0-video",
  "link_url": "https://example.com/products/travel-backpack",
  "prompt": "Make a 15-second vertical product story. Use only features stated on the page. Show the opening, laptop sleeve, and carry-on fit in that order.",
  "size": "9:16",
  "resolution": "720P",
  "duration": 15
}

공개는 쿠키, JavaScript 전용 인증, 회사 VPN, 지역별 로그인 없이 가져올 수 있음을 의미합니다. 브라우저에서 로드되는 페이지도 원격 가져오기에는 접근 불가능할 수 있습니다.

모델에 편집 지시사항 제공, "비디오 만들어"가 아니라

문서는 30초 비디오가 표시할 수 있는 것보다 더 많은 것을 설명합니다. 프롬프트는 모델에 무엇을 보존할지, 어떤 종류의 편집을 할지 말해야 합니다.

유용한 프롬프트는 5가지 질문에 답합니다:

누가 대상입니까?
생존해야 할 하나의 주장이 무엇입니까?
어떤 사실이나 시각 자산을 사용해야 합니까?
장면 순서는 무엇이어야 합니까?
무엇을 발명하면 안 됩니까?

예를 들어 재무 보고서의 경우:

Create a 25-second internal update for employees. Open with revenue growth,
then show the two regions responsible, and finish on the stated Q4 priority.
Do not invent customer names, forecasts, or percentages. Read numbers exactly
as written. Use charts as visual references rather than recreating their labels.

이것이 생성 픽셀의 완벽한 숫자를 보장하지는 않습니다. 모호함을 줄이고 검토자에게 수락 체크리스트를 제공합니다.

문서를 먼저 직접 추출할 때

직접 문서 입력은 빠르지만 전처리가 더 나은 경우:

생성 전에 모든 주장을 승인해야 할 때;
문서가 보내면 안 되는 민감한 페이지를 포함할 때;
관련된 단락이 두 개뿐일 때;
원하는 비디오가 30초보다 길 때;
스크립트, 샷 리스트, 보이스오버가 별도 검토가 필요할 때;
소스에 정확히 나타나야 할 조밀한 테이블이 있을 때.

이런 경우 승인된 텍스트를 추출하고, 장면 계획을 작성하고, 최종 프롬프트와 작은 시각 참고자료 세트를 보냅니다. 추가 단계는 안정적인 감사 추적을 만들고 관련 없는 부록이 출력을 조종하는 것을 방지합니다.

문서를 참고 미디어와 결합할 수 있습니다

Wan 3.0의 참고 패밀리는 최대 10개의 이미지, 5개의 짧은 참고 비디오, 5개의 오디오 클립을 수용합니다. 제품 개요는 사실을 제공하는 동안 이미지는 제품을 정의하고 짧은 클립은 원하는 동작을 정의할 수 있습니다.^[1]

세트를 작게 유지합니다. 색이나 모양에 불일치하는 10개의 이미지는 3개의 명확한 보기보다 나쁩니다. 프롬프트에서 중요한 자산을 이름 지정하고 역할을 설명합니다.

원격 문서를 시스템을 떠나는 데이터로 취급합니다

문서-비디오는 모델이 파일을 가져와서 해석할 수 있기 때문에 편리합니다. 같은 행동은 파일이 호스팅 서비스로 전송됨을 의미합니다. 제출 전에 소스를 분류하고 비디오가 필요하지 않은 것을 제거합니다.

안전한 전처리 체크리스트:

숨겨진 슬라이드, 발표자 노트, 추적된 변경사항, 부록 삭제;
승인된 워크시트 또는 페이지 범위만 내보내기;
필수적이지 않은 경우 고객 이름 및 내부 식별자 바꾸기;
비동기 작업에 서명된 URL이 충분히 늦게 만료되는지 확인합니다;
기밀 자료에 공개 영구 URL 피하기;
비디오 생성에 사용된 정확한 소스 버전 유지합니다.

50페이지의 API 제한은 최대값이지 권장값이 아닙니다. 3페이지 승인 추출은 모델에 더 명확한 개요를 제공하고 50페이지 이사회 패킷보다 적은 정보를 노출합니다.

생성 후 사실 검토 추가

소스 문서는 콘텐츠를 안내할 수 있지만 비디오는 생성 미디어로 남습니다. 시각적 품질만 보는 것이 아니라 짧은 팩트시트에 대해 검토하세요.

검토 항목	검증 방법
제품 외형	승인된 참고 이미지와 비교
말로 된 주장	출력을 필사하고 개요와 비교
화면 텍스트	프레임 단위로 읽기; 잘못되면 후작업에서 바꾸기
숫자/날짜	소스와 대조; 외형에서 추론하지 말 것
필수 제외	금지된 이름, 로고, 주장이 없음을 확인
장면 순서	프롬프트의 요청된 시퀀스와 비교

정확한 텍스트가 중요하면 비디오 생성 후 결정론적 오버레이로 렌더링합니다. "스프레드시트에 표시된 것과 같은 테이블"을 요청하는 것은 픽셀의 정확한 테이블 셀을 보장하지 않습니다.

긴 소스 자료를 비디오 시리즈로 분할합니다

30초는 제품 설명서, 분기 보고서, 전체 과정을 다루기에 충분하지 않습니다. 모든 섹션을 급한 클립으로 압축하는 것을 피합니다. 소스를 독립적인 주장으로 나누고 각각에 승인된 추출과 시각적 개요를 제공합니다.

예를 들어 제품 페이지는 3개의 비디오가 될 수 있습니다: 문제와 대상, 핵심 워크플로, 설정 또는 가격책정. 각 요청은 소스의 작은 부분으로 추적 가능합니다. 시리즈는 더 명확한 수락 기준을 생성하고 실패한 섹션을 나머지를 위해 지불하지 않고 재생성할 수 있게 합니다.

분할은 문서 페이지 매김이 아니라 독자 의도를 따라야 합니다. 슬라이드 1-10은 자체로 의미 있는 에피소드입니다.

일반적인 실패 지점

증상	가능한 원인	수정 사항
요청이 즉시 거부됨	`file_url`과 `link_url` 모두 전송됨	하나만 유지하기
URL이 브라우저에서만 작동	로그인, 쿠키, 비공개 네트워크 필요	공개 서명 URL 또는 승인된 스토리지 사용
비디오가 핵심 주장 무시	소스가 기간에 비해 너무 광범위함	프롬프트에서 주장과 장면 순서 지정
화면 숫자가 잘못됨	생성 비디오가 텍스트를 다시 그리고 있음	정확한 텍스트를 후작업에 추가하거나 결정론적 오버레이 사용
출력이 일반적인 광고처럼 느껴짐	프롬프트가 대상 또는 증거를 정의하지 않음	대상, 필수 사실, 제외 명시