Seedance 2.5 icon

Seedance 2.5 API

ByteDance의 Seedance 2.5를 하나의 통합 API로 사용해 시네마틱 AI 비디오를 생성하세요. 단일 REST 엔드포인트, 비동기 작업, 웹훅을 갖추었으며 별도의 ByteDance 계정을 관리할 필요가 없습니다.

Seedance 2.5을(를) 단 한 번의 API 호출로 통합하세요. 하나의 키, 하나의 통합 엔드포인트, 그리고 Apiframe의 모든 모델에 적용되는 통합 청구.

model: "seedance-2.5"

Seedance 2.5의 특별한 점

더 정교해진 멀티모달 감독

Seedance 2의 작업 흐름을 이어받아 텍스트·이미지·오디오·비디오 참조를 한 번의 생성에서 받아들이고, 각 참조에 역할을 태그해 스타일·모션·사운드 중 무엇을 이끌지 모델에 알려줄 수 있습니다.

네이티브 동기화 오디오

생성과 동시에 음악·효과음·비트에 맞춘 컷·립싱크를 입혀, 이후에 사운드트랙을 따로 추가할 필요가 없습니다.

더 탄탄한 모션과 물리

Seedance 2보다 모션 안정성과 물리적 타당성이 향상되어, 빠른 액션과 다중 피사체 장면, 복잡한 상호작용에서도 잘 무너지지 않습니다.

시네마틱 멀티샷 시퀀스

한 번의 생성으로 자연스러운 컷과 전환을 가진 여러 샷을 이어, 하나의 클립이 단일 촬영이 아니라 편집된 시퀀스처럼 읽힙니다.

강화된 캐릭터 일관성

움직임·각도 변화·장면 전환 전반에서 캐릭터의 정체성을 일정하게 유지해 영화, 브랜드 영상, 연작 콘텐츠에 중요합니다.

편집과 확장 내장

특정 클립·캐릭터·액션·스토리라인을 조정하고 요소를 교체·제거하며, 전체 클립을 다시 생성하지 않고 샷을 확장할 수 있습니다.

Seedance 2.5(으)로 제작

Apiframe의 Seedance 2.5 API로 생성한 출력 예시입니다.

샘플 준비 중

Drone shot flying over a tropical coastline at sunrise, smooth cinematic motion

샘플 준비 중

A vintage car driving through a rainy neon city at night, reflections on the asphalt

샘플 준비 중

Time-lapse of clouds rolling over a mountain range in warm golden light

개요

엔드포인트
POST /v2/videos/generate
모델 ID
seedance-2.5
파라미터 키
seedanceParams
모달리티
비디오
제공업체
ByteDance
평균 완료 시간
~120s

기능

화면 비율21:9, 16:9, 4:3, 1:1, 3:4, 9:16
해상도480p, 720p, 1080p
길이4초, 6초, 8초, 10초, 12초, 15초
이미지 입력지원
오디오지원
평균 시간~120초

빠른 시작

API 키와 함께 POST /v2/videos/generate 요청을 한 번 보내면 Seedance 2.5로 생성이 시작됩니다. 응답으로 폴링하거나 웹훅으로 받을 수 있는 jobId가 반환됩니다.

curl -X POST https://api.apiframe.ai/v2/videos/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "seedance-2.5",
        "seedanceParams": {
            "resolution": "720p",
            "start_image": "https://example.com/input.jpg",
            "generate_audio": false,
            "end_image": "https://example.com/input.jpg"
        }
    }'
import requests

response = requests.post(
    "https://api.apiframe.ai/v2/videos/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "seedance-2.5",
        "seedanceParams": {
            "resolution": "720p",
            "start_image": "https://example.com/input.jpg",
            "generate_audio": False,
            "end_image": "https://example.com/input.jpg"
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }
const response = await fetch("https://api.apiframe.ai/v2/videos/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
    "model": "seedance-2.5",
    "seedanceParams": {
      "resolution": "720p",
      "start_image": "https://example.com/input.jpg",
      "generate_audio": false,
      "end_image": "https://example.com/input.jpg"
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

응답 및 작업 수명 주기

생성은 비동기로 처리됩니다. 제출이 성공하면 202 AcceptedjobId가 반환됩니다. 상태가 COMPLETED가 될 때까지 GET /v2/jobs/{id}를 폴링하거나 webhook_url을 지정하면 result 필드에 출력 URL이 담깁니다.

1. 제출 응답 (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. 결과 폴링

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"
import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])
let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

입력 스키마

Seedance 2.5 엔드포인트가 허용하는 요청 파라미터입니다. 모델별 옵션은 아래에 표시된 파라미터 객체 안에 중첩됩니다.

파라미터 유형 필수 기본값 허용값 / 범위 설명
prompt string 필수 생성할 내용에 대한 텍스트 설명.
model string 필수 "seedance-2.5" "seedance-2.5" 이 엔드포인트의 모델 식별자.
seedanceParams.resolution string 선택 "720p" "480p", "720p", "1080p" Resolution
seedanceParams.start_image string (URL) 선택 Use a still as the first frame of the clip.
seedanceParams.generate_audio boolean 선택 false Generate audio
seedanceParams.end_image string (URL) 선택 Optional last frame to control the ending.
seedanceParams.reference_image_urls string[] (URLs) 선택 Reference images
seedanceParams.reference_video_urls string[] (URLs) 선택 Reference videos
seedanceParams.reference_audio_urls string[] (URLs) 선택 Reference audio
seedanceParams.return_last_frame boolean 선택 false Also return the final frame as a still image.
seedanceParams.web_search boolean 선택 false Web search
seedanceParams.camera_fixed boolean 선택 false Disable camera movement.
seedanceParams.seed number 선택 step 1 Reuse a number to reproduce the same result.

자주 묻는 질문

Seedance 2.5 API에 대한 일반적인 질문입니다.

Seedance 2.5는 무엇인가요?

ByteDance의 최신 멀티모달 AI 비디오 생성 모델로, Seedance 2를 발전시켜 모션·오디오·일관성을 강화했습니다.

어떤 입력을 지원하나요?

텍스트·이미지·오디오·비디오를 지원하며, 이를 결합하고 역할을 태그해 출력을 제어할 수 있습니다.

오디오를 생성하나요?

네. 음악·효과음·비트 동기화·립싱크를 포함한 동기화된 네이티브 오디오를 생성합니다.

클립 길이와 해상도는 어떻게 되나요?

최대 15초이며, 최대 1080p와 여러 화면 비율을 지원합니다. 요금은 출력 1초 단위로 부과됩니다.

비디오를 편집하고 확장할 수 있나요?

네. 클립·캐릭터·액션을 수정하고 요소를 교체하며 샷을 확장하거나 이어갈 수 있습니다.

요금은 어떻게 계산되나요?

생성된 비디오 1초 단위로 청구되므로 긴 클립일수록 그만큼 비용이 늘어납니다. 성공한 생성에 대해서만 비용을 지불합니다.

아직 궁금한 점이 있으신가요?

Seedance 2.5 API로 개발을 시작하세요

API 키를 받아 몇 분 만에 Seedance 2.5을(를) 통합하세요 — 사용한 만큼 지불.

무료 크레딧으로 시작
모든 모델을 위한 하나의 API
웹훅, SDK 및 멱등성
제공업체 계정 불필요

궁금하신 점이 있으신가요? Discord에 참여하거나 영업팀에 문의하세요.