ListenHubDocs
API 레퍼런스AI 비디오

Seedance

Seedance 2.0 및 2.5 모델, 소재 제한, Draft 생성과 과금 안내.

POST /v1/video-generation/generate를 사용합니다. 2.5는 추가 모델이며 2.0 Pro와 Fast도 계속 선택할 수 있습니다. model을 생략하면 2.0 Fast가 기본값입니다.

인증, 폴링, 목록 및 오류는 AI 동영상 개요.

모델별 제한

ModelRPM
doubao-seedance-2-pro5
doubao-seedance-2-fast5
doubao-seedance-2-55
항목2.0 Pro / Fast2.5
프롬프트 글자 수30005000
출력 길이(초)4–154–30 / -1
참조 이미지930
참조 동영상3개, 각각 2–15초, 합계 ≤15초10개, 각각 2–30초, 합계 ≤30초. 편집 시 각각 ≥4초
참조 오디오3개. 이미지 또는 동영상도 필요10개, 각각 2–30초, 합계 ≤30초. 오디오만 입력 가능
ResolutionPro: 480p / 720p / 1080p; Fast: 480p / 720p480p / 720p / 1080p; Draft: 480p
화면 비율16:9, 4:3, 1:1, 3:4, 9:16, 21:916:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

2.5 기본값: resolution: "720p", ratio: "adaptive", duration: 5, omniReferenceTaskType: "auto", draft: false.

2.5 모드 및 소재 메타데이터

omniReferenceTaskType은 auto(기본값), reference, edit, extend입니다. 편집과 연장에는 동영상 입력과 ratio: "adaptive"가 필요합니다. 편집은 duration: -1도 필수입니다. 첫 프레임 및 첫·마지막 프레임 생성도 adaptive를 사용합니다. adaptive는 출력 크기, -1은 길이를 공급자가 결정하도록 하는 명시적인 값입니다. 여러 동영상을 편집할 때는 프롬프트에서 대상을 지정하세요.

first_frame은 1개이며 last_frame은 선택적으로 1개 추가할 수 있습니다. 프레임과 참조 이미지·동영상·오디오는 혼합할 수 없습니다. 참조 역할은 reference_image, reference_video, reference_audio입니다.

각 소재 메타데이터는 image_url, video_url, audio_url 객체의 url과 같은 위치에 넣습니다. 동영상과 오디오마다 duration(초)이 필수입니다. 실제 width, height, size(바이트), 동영상의 fps도 알고 있다면 전달하세요. 합계 길이 하나로 개별 메타데이터를 대체할 수 없습니다.

이미지: 각 변 300–6000픽셀, 비율 0.4–2.5(경계 포함), 30 MiB 미만. 동영상: 각 변 300–6000, 비율 0.4–2.5, 면적 407,696–8,295,044픽셀, 24–60 fps, 최대 200 MiB. 오디오는 최대 15 MiB입니다. 동영상과 오디오는 각각 합계 30초 이하여야 합니다.

2.5 참조 생성 요청

{
  "model": "doubao-seedance-2-5",
  "content": [
    { "type": "text", "text": "Use Video 1 motion and Audio 1 rhythm" },
    {
      "type": "video_url",
      "role": "reference_video",
      "video_url": {
        "url": "https://example.com/reference.mp4",
        "width": 1280,
        "height": 720,
        "duration": 5,
        "fps": 24,
        "size": 8000000
      }
    },
    {
      "type": "audio_url",
      "role": "reference_audio",
      "audio_url": {
        "url": "https://example.com/reference.wav",
        "duration": 4,
        "size": 800000
      }
    }
  ],
  "omniReferenceTaskType": "reference",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 10,
  "requestId": "reference-request-unique-id"
}

Draft → 정식 생성

draft: true, resolution: "480p"로 재생 가능한 초안을 만들고 success까지 폴링합니다. 생성 후 14일 이내에 ListenHub의 taskId를 draftTaskId로 전달해 새 1080p 정식 작업을 생성합니다. 초안은 같은 사용자와 앱/API 식별 범위에 속해야 합니다. 서버가 원래 입력과 채널을 복원하므로 정식 요청에서는 콘텐츠와 다른 생성 설정을 생략합니다.

{
  "model": "doubao-seedance-2-5",
  "draftTaskId": "507f1f77bcf86cd799439011",
  "requestId": "final-request-unique-id"
}

의도한 새 생성마다 새 requestId(8–128자)를 사용하고 동일한 제출의 네트워크 재시도에는 재사용하세요. UUID를 사용할 수 있습니다. 작업 상세에는 선택적인 draft, draftTaskId, finalTaskIds가 있으며, 접근 가능한 생성 결과의 draftEpisodeId, finalEpisodeIds가 포함될 수도 있습니다.

견적 및 정산

초안과 정식 생성은 별도 작업으로 각각 과금됩니다. 정식 비용에서 초안 비용을 빼거나 초안 출력을 참조 동영상으로 다시 계산하지 않습니다. 정식 작업이 실패하면 해당 작업의 선차감액만 환불하고 성공한 초안은 유지합니다.

POST /v1/video-generation/estimate-credits에 생성과 같은 모델, 해상도, 비율, 길이, omniReferenceTaskType, draft를 전달합니다. referenceImages, referenceVideos, referenceAudios는 role과 각 파일 메타데이터를 담는 배열이며 URL은 넣지 않습니다. 정식 작업 견적에는 model과 draftTaskId만 전달합니다.

동영상 견적은 입력 동영상의 총 길이와 출력 길이, 출력 크기, 24 fps 및 최소 토큰 규칙을 사용합니다. 입력 동영상의 원래 크기는 검증에 쓰이며 각 입력의 픽셀 면적으로 개별 과금하지 않습니다. 오디오만 있으면 동영상 입력 없는 단가를 적용하고 오디오 길이는 동영상 길이에 더하지 않습니다. 자동 설정은 보수적으로 견적을 계산하고 완료 후 실제 토큰 사용량으로 정산합니다. 견적은 최대 금액을 보장하지 않습니다.

2.5는 별도 단가표를 사용합니다. 2.0 Pro 대비 480p / 720p는 동영상 입력 없을 때 52.86%, 있을 때 48.84% 높습니다. 1080p는 각각 51.95%, 48.94% 높습니다. 모든 작업의 인상률이나 고정 이익률을 뜻하지 않습니다.

OpenAPI 견적은 내부 크레딧 대신 tokens와 estimatedCostUsd를 반환합니다. 제출 시 선차감하고 실제 토큰 사용량에 따라 차액을 환불하거나 추가 차감합니다. 작업 ID를 보관하고 재시도 전에 상태를 확인하세요.

실패 및 재시도

개별 소재 길이가 없거나 프레임과 참조 역할을 혼합하거나 모드·비율·길이가 맞지 않으면 요청 검증에 실패합니다. 예를 들어 edit에 duration: 5를 쓰면 안 됩니다. adaptive와 -1을 사용하세요.

초안이 없거나 접근할 수 없으면 32001, 미완료·만료·조건 불일치이면 32004를 반환합니다. 예를 들어 생성 후 14일이 지난 초안으로는 정식 작업을 만들 수 없으므로 새 초안을 생성해야 합니다.

공급자 심사 거부나 실패는 작업의 실패 상태와 기존 오류 필드로 반환됩니다. 5000자는 제품 상한이며 공급자의 수락을 보장하지 않습니다. 제출 시간이 초과되면 새 작업을 만들기 전에 기존 작업을 조회하거나 같은 요청 ID로 재시도하세요.

이 페이지의 내용