SamurAIGPT/Seedance-2.5-API

What it solves

이 프로젝트는 ByteDance가 개발한 Seedance 2.5 API에 대한 포괄적인 Python 래퍼를 제공하여 개발자가 프로그래밍 방식으로 고충실도 AI 비디오를 생성할 수 있게 합니다. 텍스트 프롬프트, 정적 이미지, 또는 멀티모달 참조의 조합으로부터 시네마틱 클립을 만드는 과정을 간소화하며, 특히 서로 다른 장면에서 일관된 인간 얼굴과 캐릭터 정체성을 유지하는 과제를 구체적으로 해결합니다.

How it works

이 라이브러리는 MuAPI를 통해 제공되는 Seedance 2.5 모델용 SDK 역할을 합니다. 다양한 엔드포인트와 상호작용하는 고수준 Python 메서드를 제공하며, 포함 사항은 다음과 같습니다:

• Text-to-Video (T2V) 및 Image-to-Video (I2V) 생성.
• Omni-Reference: 최대 30개의 이미지, 10개의 비디오, 10개의 오디오 클립을 동시에 사용하여 비디오 생성에 조건을 부여합니다.
• Character Consistency: 사용자가 1-3장의 참조 사진으로부터 4K 캐릭터 시트를 만들고, 고유 ID(@character:<id>)를 사용하여 해당 캐릭터를 참조하거나, 시트를 앵커 이미지로 사용하여 더 높은 충실도를 얻는 특화된 워크플로입니다.
• Video Editing: 텍스트와 이미지 프롬프트를 사용하여 기존 비디오 수정.
• Synced Audio: 일치하는 음성, 사운드 효과 및 배경 음악 생성.

Who it’s for

• AI Video Creators: 현실적인 인간 얼굴을 가진 고품질 시네마틱 클립을 제작하려는 사람들.
• Developers: ByteDance의 비디오 생성 모델에 대한 강력한 Python 인터페이스가 필요한 AI 비디오 애플리케이션 또는 SaaS 플랫폼을 구축하는 사람들.
• AI Agents: 이 프로젝트는 Claude나 Cursor와 같은 AI 모델이 직접 비디오 생성 도구를 트리거할 수 있게 하는 MCP(Model Context Protocol) 서버를 포함합니다.

Highlights

• Extended Clip Length: 30초 길이까지의 클립을 지원합니다.
• Realistic Human Faces: "uncanny valley"를 피하기 위해 얼굴 충실도와 정체성 일관성에 특화된 초점을 맞춥니다.
• Multimodal Conditioning: 단일 요청에서 이미지, 비디오, 오디오를 참조로 사용할 수 있는 기능.
• idée Fixed-Camera Control: 모델이 정지된 샷을 선호하도록 편향시키는 camera_fixed 옵션.
• High-Fidelity Formats: 색 drift 및 오디오 desync를 방지하기 위해 .mov (yuv444p + PCM 오디오) 형식 지원.
• Permissive Content Policy: 많은 경쟁 AI 비디오 모델에 비해 더 유연한 콘텐츠 정책.