ToolPic

Seedance 2.5 API — 파라미터, 스키마, 호출 방법

Seedance 2.5 API 완전 레퍼런스. content, ratio, resolution, duration, generate_audio, output_format으로 ModelArk 요청 본문을 구성하고 무료로 복사하세요.

Describe your scene — Seedance 2.5 generates up to 30 seconds of native audio-visual output.

Tip: put spoken dialogue in "double quotes" for better synced audio.

10s
Optimized Seedance prompt

a cinematic scene. with natural ambient sound.

API request body (ModelArk)
{
  "model": "dreamina-seedance-2-5-260628",
  "content": [
    {
      "type": "text",
      "text": "a cinematic scene. with natural ambient sound."
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 10,
  "generate_audio": true,
  "camera_fixed": false,
  "output_format": "mp4"
}

파일은 브라우저에서 로컬로 처리됩니다. 어떤 서버에도 업로드되지 않습니다.

Seedance 2.5 API 호출 방법

1

요청 구성하기

모델을 dreamina-seedance-2-5-260628(글로벌) 또는 doubao-seedance-2-5-260628(중국)로 설정하고, 프롬프트를 content 텍스트 항목으로 추가하세요. 위의 빌더가 전체 JSON을 자동으로 작성해 줍니다.

2

파라미터 설정하기

ratio, resolution(480p 또는 720p), 최대 30초의 duration, generate_audio, camera_fixed, output_format(mp4 또는 mov)을 선택하세요. 재현 가능한 결과를 원하면 seed를 추가하세요.

3

전송하고 폴링하기

요청 본문을 ModelArk 영상 생성 엔드포인트에 POST한 뒤, 작업을 폴링하거나 callback_url을 사용해 queued, running, succeeded, failed 상태 업데이트를 받으세요.

Seedance 2.5 API 자주 묻는 질문

Seedance 2.5 API 요청은 어떤 형태인가요?

요청에는 모델 ID와 content 배열이 필요합니다. content 배열에는 텍스트 항목(프롬프트, 최대 5000자)과 함께 first_frame, last_frame 또는 reference_image 역할을 갖는 선택적 image_url 항목이 들어갑니다. 그와 함께 ratio, resolution, duration, generate_audio, camera_fixed, output_format을 설정합니다.

API는 어떤 해상도와 길이를 지원하나요?

출시 시점에 API는 480p와 720p(720p가 기본값)를 지원하며, 1080p와 4K가 예정되어 있습니다. 길이는 한 번의 생성에서 4초부터 30초까지입니다. frames 파라미터로 길이를 정밀하게 지정할 수도 있으며, 이는 duration보다 우선합니다.

배치 작업을 위한 더 저렴한 등급이 있나요?

있습니다. service_tier 파라미터는 flex를 받아들이는데, 이는 오프라인 모드로 온라인 추론의 약 50% 가격에 더 높은 일일 할당량을 제공하여 지연 시간이 중요하지 않을 때 이상적입니다. 기본 등급은 시간에 민감한 요청을 위한 온라인 추론입니다.