LogoWan API 문서
홈페이지
X (Twitter)
홈페이지

시작하기

개요연동 가이드잔액 확인작업 삭제

Wan 모델

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Seedance 모델

Seedance 2.5Seedance 2.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

이미지 모델

Seedream 5.0 ProSeedream 5.5 API

언어 모델

Claude APIClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2GPT APIGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

Seedance 2.5 Flash

Seedance 2.5 Flash API 레퍼런스: 동영상 생성, 프레임 및 참조 자료, 요청 예시, 작업 폴링, 다운로드 및 요금입니다.

텍스트, 프레임 또는 참조 자료로 동영상을 생성하거나 소스 클립을 편집합니다. 모델 및 플레이그라운드.

작업 만들기

API 키 설정에서 서버 측 키를 만드세요. https://api.wanapi.app/v1/videos에 POST 요청을 한 번 보내고 반환된 id를 저장하세요.

curl https://api.wanapi.app/v1/videos -H "Authorization: Bearer $WAN_API_KEY" -H "Content-Type: application/json" -d '{"model":"bytedance/seedance-2.5-flash","prompt":"A paper boat floats through a sunlit stream. Slow tracking shot.","resolution":"720p","aspectRatio":"16:9","duration":4,"generateAudio":true}'

요청 필드

model: "bytedance/seedance-2.5-flash"와 비어 있지 않은 prompt를 사용하세요. resolution은 480p 또는 720p(기본값)로 설정하세요. 생성 시 duration은 4~30초(기본값 5)로 설정할 수 있습니다. 무음 출력을 원하면 generateAudio: false로 설정하세요. 작업당 출력은 하나이며, 프레임 속도는 24 fps로 고정됩니다.

텍스트 및 참조 생성에서는 고정된 aspectRatio를 사용합니다. 값은 16:9(기본값), 9:16, 1:1, 4:3, 3:4 또는 21:9입니다. 첫 프레임과 마지막 프레임을 지정하려면 시작 프레임에 image를 전달하거나, first_frame 하나와 선택 사항인 last_frame 하나를 포함한 frameImages를 전달합니다. 각 프레임 항목에는 frameType과 image URL이 있습니다. 프레임과 편집에는 적응형 프레이밍이 적용됩니다.

참조 이미지나 동영상은 각각 type: "url", url, mediaType을 포함하여 inputReferences로 전달합니다. 이미지는 최대 10개, 동영상은 5개, 오디오 클립은 5개까지 전달할 수 있습니다. 오디오 URL은 providerOptions.bytedance.referenceAudio로 전달합니다. 요청 하나에는 시작·종료 프레임 또는 참조 자료 중 한 방식만 사용합니다.

편집하려면 providerOptions.bytedance.omni_reference_task_type을 edit로 설정하고 참조 동영상 하나만 제공한 다음, duration을 생략하거나 -1로 설정합니다. 다른 작업 유형인 generate가 기본값입니다. 콘텐츠 필터링은 기본적으로 true입니다. API 클라이언트는 providerOptions.bytedance.content_filter를 false로 설정할 수 있습니다.

미디어 사양

인증 정보가 포함되지 않은 공개적으로 읽을 수 있는 HTTP(S) URL을 사용합니다. 이미지: JPEG, PNG 또는 WebP, 최대 30 MB. 이미지와 동영상: 변의 길이 300–6000 픽셀, 화면 비율 0.4–2.5.

동영상: MP4 또는 MOV, 최대 200 MB, 24–60 fps, 409600–8295044 픽셀. 참조 동영상 길이는 2–30초이며, 편집 원본은 4–30초입니다. 동영상 참조 자료의 총길이는 최대 30초입니다.

오디오: MP3 또는 WAV, 클립당 최대 15 MB 및 2–30초, 총길이 최대 30초.

폴링 및 다운로드

같은 API 키로 GET https://api.wanapi.app/v1/videos/{id}를 폴링합니다. 상태가 queued 또는 in_progress인 작업은 계속 폴링합니다. 상태가 completed이면 videos[0].url을 다운로드합니다. 상대 URL은 API 호스트를 기준으로 확인하고 해당 호스트에서 인증합니다. 서명된 미디어 URL은 그대로 사용합니다. 상태가 failed이면 error.message를 확인합니다. 폴링에 실패하면 같은 작업 ID로 다시 시도합니다.

요금

청구 초당 USD
해상도동영상 입력 없이동영상 입력 포함
480pUS$0.096US$0.06
720pUS$0.192US$0.12

오디오가 포함되어 있습니다. 참조 및 편집 계산은 초당 과금 안내를 확인하세요.

OpenAPI 다운로드.

Seedance 2.5

Seedance 2.5 API 문서. 동영상 생성, 프레임과 참조 입력, 요청 예시, 작업 상태 조회, 다운로드 및 요금을 안내합니다.

Seedance 2.0

Seedance 2.0 API 문서. 동영상 생성, 프레임과 참조 입력, 요청 예시, 작업 상태 조회, 다운로드 및 요금을 안내합니다.

목차

작업 만들기요청 필드미디어 사양폴링 및 다운로드요금