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로 다시 시도합니다.
요금
| 해상도 | 동영상 입력 없이 | 동영상 입력 포함 |
|---|---|---|
| 480p | US$0.096 | US$0.06 |
| 720p | US$0.192 | US$0.12 |
오디오가 포함되어 있습니다. 참조 및 편집 계산은 초당 과금 안내를 확인하세요.