Alibaba: Wan 3.0

Alibaba Wan 3.0은 프롬프트, 첫 프레임이나 시작·끝 프레임, 멀티모달 참조에서 소리 있는 영상을 만듭니다. 제작사 프로파일은 스토리보드, 원본 기반 편집과 이어 만들기를 하나의 모델에 결합하며 30fps, 480p·720p·1080p 해상도의 2–30초 MP4를 출력합니다.

Ailoot Ultra · 동영상 POST /v1/videos alibaba/wan-3.0

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

Alibaba Wan 3.0은 기획과 보조 자료를 소리 있는 장면으로 바꾸도록 설계된 올인원 영상 제작 프로파일입니다. 제조사는 표준 모델을 wan3.0-video로 식별합니다. 텍스트 전용 생성, 시작·끝 프레임, 멀티모달 참조, 편집과 이어 만들기는 이 프로파일 안에서 다른 입력 구성을 사용합니다. 유용한 에셋에는 짧은 이야기, 제품 소개, 이미지 기반 전환이나 특정 창작 방향에 따라 변경한 원본 클립이 있습니다.

텍스트 전용 장면에는 피사체, 장소, 동작, 카메라, 시각 스타일과 소리를 준비하세요. 제작사는 단일 숏과 다중 숏 스토리보드를 지원하며 숏당 약 4–6초 구조와 선택적 시간 범위를 권장합니다. 짧은 이야기라면 작업대 위 작은 기계 새를 소개하고 첫 움직임을 따라간 뒤 실내 환경음이 이어지는 고정 클로즈업으로 마칠 수 있습니다. 30초 허용량이 단절된 동작 목록이 아니라 일관된 이야기를 담도록 각 부분의 시각적 관계를 설명하세요.

첫 프레임 생성은 제공 정지 이미지를 움직입니다. 정지 이미지가 초기 구도를 정하고 프롬프트는 움직임과 카메라 연출을 설명합니다. 시작·끝 프레임 생성은 끝도 고정하며 두 이미지 사이 전환을 설명합니다. 호환되는 장면과 의도한 구도를 가진 양 끝 이미지를 준비하세요. 가이드는 이 모드들에 적응형 화면비 선택을 권장합니다. 프레임 입력은 참조 이미지·영상·오디오·파일·웹 링크 구성과 분리되므로 계획 숏에 맞는 자료 모드를 선택합니다.

참조 모드는 이미지 최대 10개, 영상 클립 5개와 오디오 클립 5개를 총 20개 자료 한도 안에서 결합합니다. 이미지 참조는 캐릭터, 물체, 배경이나 스타일을 식별하고 영상은 움직임·카메라 연출, 오디오는 연기·리듬을 안내할 수 있습니다. Image 1, Video 1, Audio 1 같은 유형별 라벨은 입력 순서를 각각 따릅니다. 각 참조에 역할을 주고 상호작용을 설명하세요. 캐릭터 모습은 맞지만 배경이 틀린 문제와 카메라가 의도한 움직임을 놓친 문제는 다릅니다.

문서상 참조 파일 제한은 이미지당 20MB, 영상당 100MB, 오디오 클립당 15MB입니다. 참조 영상 전체는 15초로 제한되고 오디오 참조에는 별도의 합계 15초 제한이 있습니다. 참조 자료에 문서 1개 또는 공개 웹페이지 참조 1개를 추가할 수 있으며 문서와 링크는 서로 배타적입니다. 원본은 로그인 없이 공개 접근이 가능해야 합니다. 특히 문서에 장면에서 쓸 수 있는 것보다 많은 정보가 있으면 자료를 집중시키고 어떤 내용을 클립에 반영할지 명시하세요.

네이티브 오디오는 생성 화면과 대사, 배경 음악, 환경음과 효과음을 결합합니다. 발화 단어, 화자와 발성, 중요한 효과 및 배경 음악 유무를 명시하세요. 제작사 가이드에서 오디오는 기본으로 켜지며 끌 수 있습니다. 시연 장면에서는 짧은 소개 대사 후 제품 디테일을 보여 주고 조용한 기계 소리로 움직임을 나타낼 수 있습니다. 글로 쓴 기획만으로 판단하지 말고 완성 클립에서 실제 문구, 화자 배정과 동기화를 들어 보세요.

편집에서는 변경할 내용과 유지할 내용을 설명합니다. 가이드는 요소 추가·제거, 속성 교체, 시각 스타일·조명 변경과 대사 수정을 다룹니다. 이어 만들기에서는 기존 클립의 앞·뒤·주변에 일어날 일을 설명하세요. 적응형 구도와 스마트 길이는 원본 영상 워크플로가 형태와 타이밍 의도를 유지하도록 돕습니다. 영상 입력을 제공하면 문서상 입력·출력 영상 길이 합이 30초를 넘을 수 없습니다. 원본을 보관하고 변경 영역 및 클립 전체 연속성을 검토하세요.

출력은 30fps MP4이며 해상도는 480p·720p·1080p입니다. 신규 생성 길이는 2–30초 또는 모델이 길이를 선택하는 스마트 길이 설정입니다. 가로·정사각형·세로 형태가 문서화되어 있고 적응형 구도는 제공 자료에 적합합니다. 제조사는 요청을 작업으로 처리하고 24시간 유효한 완성 영상 위치를 반환합니다. 실제 결과, 기획과 참조를 제작 기록으로 보관하고 다른 클립과 배열하기 전에 반환 길이·구도를 확인하세요.

표준 Wan 3.0과 Prime 변형은 문서상 올인원 모드를 공유하며 Prime은 생성 속도를 강조합니다. Wan 2.7과 2.6은 작업별 길이·참조 규칙이 다르므로 인터페이스를 이 버전의 설정처럼 취급하면 안 됩니다. 완성 장면에서 캐릭터·제품 정체성, 공간 연속성, 음성, 효과, 원본 유래 디테일과 의도한 시작·끝을 검토하세요. 구체적인 다음 수정은 성공한 방향을 유지하며 클립의 실제 결함을 해결합니다.

Ailoot Ultra · 동영상 POST /v1/videos alibaba/wan-3.0

alibaba/wan-3.0

Alibaba /alibaba/wan-3.0

시작하기

허용 입력: 텍스트 · 이미지
결과: 동영상

Ailoot에서 사용 가능 · 입력 및 메서드

Ailoot Ultra · 동영상 POST /v1/videos

입력: text, image
출력: video
출력 형식: 원본 MP4 바이트(정규화·트랜스코딩 없음)

필드	유형	요건	값과 한도	기본값
필드`model`	유형`string`	요건필수	값과 한도 alibaba/wan-3.0	기본값—
필드`prompt`	유형`string`	요건필수	값과 한도	기본값—
필드`duration`	유형`integer`	요건필수	값과 한도 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 최솟값: 1 최댓값: 600	기본값—
필드`resolution`	유형`string`	요건선택 사항	값과 한도 480p, 720p, 1080p	기본값—
필드`aspect_ratio`	유형`string`	요건선택 사항	값과 한도 16:9, 4:3, 1:1, 3:4, 9:16	기본값—
필드`generate_audio`	유형`boolean`	요건선택 사항	값과 한도 false, true	기본값—
필드`frame_images`	유형`array`	요건선택 사항	값과 한도 최소 항목 수: 1 최대 항목 수: 1 입력 콘텐츠: 프레임 객체 배열입니다. 각 객체에는 type=image_url, url을 포함하는 image_url 및 frame_type이 있습니다. HTTPS 이미지 URL을 사용하고 frame_type을 first_frame으로 설정하세요. 각 프레임 역할은 최대 한 번만 나타날 수 있습니다. 정확한 키: type, image_url, frame_type 조건: 이 키는 각 프레임 객체를 설명합니다. image_url에는 url만 포함됩니다. 텍스트만 사용하는 요청에서는 frame_images를 생략하세요.	기본값—
필드`input_references`	유형`array`	요건선택 사항	값과 한도	기본값—
필드`seed`	유형`integer`	요건선택 사항	값과 한도 최솟값: -9,223,372,036,854,775,808 최댓값: 9,223,372,036,854,775,807	기본값—
필드`callback_url`	유형`string`	요건선택 사항	값과 한도 패턴: ^https://	기본값—
필드`session_id`	유형`string`	요건선택 사항	값과 한도	기본값—
필드`trace`	유형`object`	요건선택 사항	값과 한도	기본값—
필드`user`	유형`string`	요건선택 사항	값과 한도	기본값—

입력 자료 조합

텍스트로 동영상 생성 · 작성한 프롬프트입니다. · 필수: model, prompt, duration

prompt는 텍스트로, duration은 정수 단위 초로 제공하세요. 지원되는 해상도를 선택하고 필요한 경우 화면 비율을 지정하세요.

model: 유형: string · alibaba/wan-3.0

prompt: 유형: string · 최대 UTF-8 바이트 수: 10,000 · 공백이 아닌 문자 필수: 예

이미지로 동영상 생성 · 작성한 프롬프트와 첫 프레임 이미지입니다. · 필수: model, prompt, duration, frame_images

frame_images는 배열입니다. 각 프레임 객체에는 type, image_url, frame_type이 있으며, image_url에는 url이 포함됩니다. type을 image_url로 설정하세요. first_frame을 사용하세요. 각 프레임 역할은 최대 한 번만 나타날 수 있습니다. 각 프레임에 공개 HTTPS 이미지 URL을 제공하세요. 지원되는 해상도를 선택하고 필요한 경우 화면 비율을 지정하세요.

정확한 키: type, image_url, frame_type

model: 유형: string · alibaba/wan-3.0

prompt: 유형: string · 최대 UTF-8 바이트 수: 10,000 · 공백이 아닌 문자 필수: 예

Reference to video · 작성한 프롬프트와 지원되는 이미지 참조 자료입니다. · 필수: model, prompt, duration, input_references

input_references는 객체 배열입니다. type을 image_url로 설정하고 url을 포함하는 해당 필드를 사용하세요. 공개 HTTPS URL을 사용하세요. 참조 모드를 선택하려면 frame_images를 생략하세요. 지원되는 해상도를 선택하고 필요한 경우 화면 비율을 지정하세요.

model: 유형: string · alibaba/wan-3.0

prompt: 유형: string · 최대 UTF-8 바이트 수: 10,000 · 공백이 아닌 문자 필수: 예

메서드 매개변수와 수명 주기

매개변수	명세
매개변수`content_type`	명세application/json
매개변수`required`	명세model, prompt, duration
매개변수`material_types`	명세text, image
매개변수`additional_properties`	명세false
매개변수`optional_controls`	명세resolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user

수명 주기: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

요금

최종 요금 계산 방식

표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.

요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.

빠른 모드: 미지정 빠른 모드를 선택한 경우
Flex 모드: 미지정 flex 모드를 선택한 경우
최대 추론 수준: 미지정 최대 추론 수준에 default 조정값을 적용하는 경우

비교용 예상 요금

설정별 가격

각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.

설정	요금표	예측 수량	과금 단위	과금 조건	요금
설정기본 토큰 요금	요금표기본 요금	예측 수량—	과금 단위—	과금 조건—	요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰
설정동영상 요금	요금표—	예측 수량—	과금 단위동영상 초당	과금 조건resolution: 1080p	요금 출력 · 동영상 가격 · 비교 전용 추정치 $0.4 동영상 초당
설정동영상 요금	요금표—	예측 수량—	과금 단위동영상 초당	과금 조건resolution: 480p	요금 출력 · 동영상 가격 · 비교 전용 추정치 $0.1 동영상 초당
설정동영상 요금	요금표—	예측 수량—	과금 단위동영상 초당	과금 조건resolution: 720p	요금 출력 · 동영상 가격 · 비교 전용 추정치 $0.2 동영상 초당
설정예상 생성 비용	요금표—	예측 수량1회 생성 예상치	과금 단위—	과금 조건—	요금 출력 · 예상 생성 비용 · 비교 전용 추정치 $0.2 생성 전 추정치 이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다.

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →

참조 요금 상세 정보

모델 수준의 참조 요금표는 메서드 선택, 견적 또는 요금을 변경하지 않습니다. 실제 과금에는 선택한 Ailoot 메서드 요금이 적용됩니다.

동영상 설정별 요금 참조

설정별 가격

각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.

설정	과금 조건	요금
설정동영상 요금	과금 조건resolution: 480p	요금 출력 · 동영상 가격 $0.1 동영상 초당 표시된 구성의 공개 가격 참고값입니다. 최종 요금은 실제 청구된 구성을 따릅니다.
설정동영상 요금	과금 조건resolution: 720p	요금 출력 · 동영상 가격 $0.2 동영상 초당 표시된 구성의 공개 가격 참고값입니다. 최종 요금은 실제 청구된 구성을 따릅니다.
설정동영상 요금	과금 조건resolution: 1080p	요금 출력 · 동영상 가격 $0.4 동영상 초당 표시된 구성의 공개 가격 참고값입니다. 최종 요금은 실제 청구된 구성을 따릅니다.

요청 예제

Ailoot Ultra · 동영상

curl · 동영상 생성

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"alibaba/wan-3.0","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

결과 수신 및 저장

Ailoot Ultra · 동영상

소유한 콘텐츠의 서명된 URL

GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content

작업 상태 확인

GET · 원래 작업의 상태 조회

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

기타 콘텐츠 조회

완료된 내 소유 출력 모두 저장

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS

완료된 결과 모두 보관

완료된 모든 동영상과 반환된 파일을 저장하고, 실제로 반환된 모든 자산 URL에서 가져오세요.

실제로 소유한 모든 출력과 함께 반환된 측정 메타데이터를 보존하세요.

원래 응답을 확인해야 할 경우

503 result_pending_check + 원래 id + X-Should-Retry:false; 원래 요청을 절대로 재전송하지 마세요.

응답 필드

필드	유형	의미
필드`index`	유형integer	의미출력 목록에서 이 동영상의 영부터 시작하는 위치입니다.
필드`content_url`	유형string	의미완료된 이 동영상의 서명된 HTTPS 다운로드 URL입니다.
필드`sha256`	유형string \| null	의미원본 동영상 바이트의 SHA-256 다이제스트입니다. 확인할 수 없으면 null입니다.
필드`size_bytes`	유형integer \| null	의미바이트 단위 원본 동영상 파일 크기입니다. 확인할 수 없으면 null입니다.
필드`duration_ms`	유형integer \| null	의미밀리초 단위로 측정한 동영상 길이입니다. 확인할 수 없으면 null입니다.
필드`width`	유형integer \| null	의미픽셀 단위 동영상 너비입니다. 확인할 수 없으면 null입니다.
필드`height`	유형integer \| null	의미픽셀 단위 동영상 높이입니다. 확인할 수 없으면 null입니다.
필드`video_codec`	유형string \| null	의미동영상 코덱 식별자입니다. 기록되지 않았으면 null입니다.
필드`has_audio`	유형boolean \| null	의미동영상에 오디오 트랙이 포함되어 있는지 나타냅니다. 측정하지 않았으면 null입니다.
필드`audio_codec`	유형string \| null	의미오디오 코덱 식별자입니다. 식별자가 기록되지 않았으면 null입니다.

오류와 다음 단계

응답	조건	다음 단계
응답404 · `not_found_error`	조건동영상에 접근할 수 없거나 해당 동영상 ID를 찾지 못했습니다.	다음 단계동영상 접근 권한을 확인하세요. 기존 동영상에는 원래 공개 ID와 동일한 API 키를 사용하세요.
응답401 · `authentication_error`	조건API 키가 인증된 계정과 일치하지 않습니다.	다음 단계제출 전에 API 키와 계정 접근 권한을 확인하세요.
응답400 · `invalid_request_error`	조건요청을 읽을 수 없거나 다운로드 인덱스가 유효하지 않습니다.	다음 단계요청 본문을 수정하세요. 다운로드할 때는 원래 작업에서 반환된 출력 인덱스를 선택하세요.
응답422 · `price_unavailable`	조건선택한 동영상 설정의 요금을 계산할 수 없습니다.	다음 단계지원되는 동영상 설정을 선택하고 필수 옵션을 모두 지정한 뒤 수정된 요청을 제출하세요.
응답422 · `invalid_request_error`	조건동영상 입력 또는 원래 이어 만들기 작업이 유효하지 않습니다.	다음 단계유효한 HTTPS 입력을 사용하세요. 이어 만들기에는 동일한 API 키로 완료된 원본의 공개 동영상 ID를 사용하세요.
응답402 · `billing_error`	조건사용 가능한 잔액 또는 한도로는 예약할 수 없습니다.	다음 단계새 요청을 전송하기 전에 사용 가능한 잔액과 한도를 확인하세요.
응답503 · `server_error`	조건동영상 검증, 저장소 또는 서비스 접근을 일시적으로 사용할 수 없습니다.	다음 단계서비스를 사용할 수 있을 때까지 기다리세요. 이미 동영상 ID가 있으면 새로 생성하지 말고 해당 원래 작업을 확인하세요.
응답503 · `result_pending_check`	조건원래 동영상 결과와 청구액을 확인해야 합니다.	다음 단계반환된 동영상 ID를 보존하고 해당 작업을 확인하세요. 확인 중에는 대체 생성 요청을 전송하지 마세요.
응답503 · `owned_result_unavailable`	조건기존 동영상 다운로드를 일시적으로 사용할 수 없습니다.	다음 단계나중에 동일한 동영상 작업을 확인하고 기존 출력을 다운로드하세요. 새로 생성하면 별도의 작업이 만들어집니다.
응답409 · `video_not_ready`	조건동영상 콘텐츠가 게시되지 않았습니다.	다음 단계원래 작업 상태를 확인하세요. completed를 보고하면 다운로드하고, failed를 보고하면 청구 확인 안내를 따르세요.

별칭

모델 별칭

Ailoot Ultra alibaba/wan-3.0

메서드 경로 별칭

위에 표시된 메서드 경로를 사용하세요.

Alibaba: Wan 3.0

Alibaba: Wan 3.0

시작하기

Ailoot에서 사용 가능 · 입력 및 메서드

요금

최종 요금 계산 방식

비교용 예상 요금

설정별 가격

참조 요금 상세 정보

설정별 가격

요청 예제

Ailoot Ultra · 동영상

결과 수신 및 저장

Ailoot Ultra · 동영상

작업 상태 확인

완료된 결과 모두 보관

원래 응답을 확인해야 할 경우

별칭

모델 별칭

메서드 경로 별칭

관련 호출용 ID

회사와 그 프로젝트 포트폴리오

할인받아 토큰을 구매하세요.

판매하는 제품에 API를 연결하세요.