Seedance 2.0 이용 방법 | 키 발급과 첫 렌더

Seedance 2.0 이용 방법을 단계별로: 어떤 창구를 고를지, 키 발급, 첫 요청에 필요한 필드, 비용, 그리고 첫 호출이 실패하는 이유.
ByteDance가 직접 내놓은, Seedance 2.0을 바로 쥐여 주는 소비자용 앱은 없습니다. 실무에서 Seedance 2.0 이용 방법이란 이 모델을 되파는 창구 중 하나를 고르고, 자격 증명을 받고, 형태가 맞는 요청을 보내는 일을 뜻합니다. 이 글은 그 경로를 처음부터 끝까지 따라가며, 첫 클립의 비용과 첫 호출이 대개 실패하는 네 가지 이유를 짚습니다.
어느 것도 오래 걸리지 않습니다. 어려움의 대부분은 각 창구가 여러분 대신 조용히 결정해 버리는 것들에 있습니다.
모델을 실어 나르는 창구들
접근은 세 가지 형태로 옵니다. 어느 쪽을 고르느냐가 무엇을 제어할 수 있는지를 결정합니다.
소비자용 영상 앱은 텍스트 입력창, 몇 가지 프리셋, 크레딧 잔액을 줍니다. 키도 코드도 없습니다. 첫 클립까지 가장 빠른 경로이자 가장 많은 것을 감추는 경로입니다. 길이 상한, 해상도 다운그레이드, 워터마크는 모델이 아니라 앱이 적용하며, 자신이 어떤 버전을 받고 있는지조차 알 수 없는 경우가 많습니다.
호스팅 API는 키와 날것의 요청을 줍니다. 모델이 노출하는 모든 파라미터에 손이 닿고, 과금은 크레딧이 아니라 완성 영상의 초 단위이며, 무언가 실패했을 때 실제 오류를 읽을 수 있습니다. 대신 HTTP를 직접 보내야 합니다.
번들 통합은 이미 결제해 쓰고 있는 편집 도구나 디자인 도구 안에 모델을 넣어 줍니다. 그 도구 안에서 살고 있다면 편리하지만, 파라미터 집합은 셋 중 가장 좁은 것이 보통입니다.
첫인상을 넘어서는 무엇이든 하려면, 여러분이 실제로 무엇을 받고 있는지 알려 주는 쪽은 API 경로입니다.
첫 요청 전에 필요한 것
세 가지입니다.
고른 플랫폼의 계정, 그리고 거기에 연결된 결제 수단. 플랫폼 대시보드에서 발급받아 Authorization: Bearer 헤더로 보내는 API 키. 그리고 생성을 이미지로 조건화할 계획이라면 그 이미지의 공개적으로 접근 가능한 URL. 미디어 입력은 공개 HTTP 또는 HTTPS 링크여야 합니다. 데이터 URI는 플랫폼 전역에서 거부되므로, 노트북에 있는 파일은 먼저 어딘가에 업로드해야 합니다.
키는 베어러 자격 증명입니다. 그것을 쥔 사람은 누구나 여러분의 잔액을 쓸 수 있으므로, 서버 쪽에 두고 브라우저 번들에서 빼내십시오.
호스팅 API로 Seedance 2.0 이용하기
호출은 플랫폼의 영상 생성 엔드포인트로 JSON 본문을 보내는 POST이고, 영상이 아니라 작업 id를 반환합니다. 네 개의 필드가 요청 전체를 실어 나릅니다.
- 모델 식별자. 원하는 버전의 공식 문서에서 그대로 복사한 문자열
- 프롬프트. 말로 옮긴 무드보드가 아니라 숏 설명
- 초 단위 길이. 2.0에서는 15를 넘을 수 없습니다
- 해상도. 480p, 720p, 1080p 중 하나
4K 설정은 없습니다. 그 천장은 모든 호스트에서 동일하며, 이 모델에 4K를 광고하는 페이지는 출시 전 주장을 그대로 옮기고 있는 것입니다.
모델 문자열은 기억에 의존해 타이핑하지 말고 복사하십시오. 이 계열의 식별자는 정밀하게 버전이 매겨져 있고, 온라인에 떠도는 옛 코드 샘플은 더 이상 해석되지 않는 문자열을 인용합니다. 잘못된 식별자는 작업이 생성되기 전에 검증에서 실패하므로 비용은 들지 않지만, 오타가 아니라 접근 권한 문제처럼 읽히는 오류를 냅니다.
폴링, 그리고 기다림
생성은 비동기입니다. 생성 호출은 작업 id와 함께 즉시 반환되고, 여러분은 상태가 종료 상태가 될 때까지 작업 엔드포인트를 폴링합니다. 폴링은 무료이므로 공격적으로 간격을 늘릴 이유가 없습니다.
2~5분을 예상하십시오. 20분이 지나도 끝나지 않은 작업은 잘못된 것이고, 환불 경로는 다른 실패와 같습니다.
작업이 성공하면 응답에 완성 파일의 URL이 담겨 옵니다. 내려받으십시오. 호스팅된 결과 URL은 영구 보관소가 아닙니다.
첫 클립의 비용
과금은 완성 영상의 초 단위이고 해상도에 따라 값이 매겨집니다. 아래는 Seedance 2.5의 공개 요금이며, 초당 더 낮게 책정된 2.0의 상한 역할을 합니다:
| 해상도 | 2.5 생성만 | 2.5 레퍼런스 영상 포함 |
|---|---|---|
| 480p | $0.118589 | $0.071153 |
| 720p | $0.266824 | $0.160094 |
| 1080p | $0.461856 | $0.275904 |
2.5에서 480p 5초 클립은 대략 $0.59이고, 2.0에서는 그보다 적습니다. 첫 렌더에 들어야 할 비용이 그 정도입니다. 1080p가 아니라 거기서 시작해 파이프라인이 끝까지 도는지 확인하고, 프롬프트가 먹힌다는 것을 안 뒤에 해상도를 올리십시오.
실패한 작업은 콘텐츠 검열 거부를 포함해 전액 환불되므로, 잘못된 실험은 청구로 이어지지 않습니다.
첫 호출이 실패하는 이유
네 가지 원인이 대부분을 설명합니다.
15초를 넘는 길이. 2.0의 하드 천장이며 검증 단계에서 거부됩니다. 더 길어야 한다면 목표는 30초까지 가는 Seedance 2.5입니다.
로컬 또는 data: 미디어 URL. 플랫폼 전역에서 거부됩니다. 업로드한 뒤 공개 링크를 넘기십시오.
폐기된 모델 문자열. 검증 오류이고, 작업도 생성되지 않고 과금도 없습니다.
안전 거부. 80006 오류로 반환됩니다. 어느 단계에서 걸렸는지 알려 주지 않으므로 프롬프트, 레퍼런스 이미지, 생성된 출력이 모두 후보입니다. content_filter 파라미터는 기본값이 true이고, false로 두면 검열을 끄지 않은 채 덜 제한적인 채널로 라우팅됩니다. 그 아래에서 모델은 실명이 거론된 실존 유명인, 제3자 지식재산, 불법 콘텐츠를 차단하며, 어떤 호스트 설정으로도 바뀌지 않습니다.
자주 묻는 질문
코드를 쓰지 않고 Seedance 2.0을 이용할 수 있습니까? 네, 소비자용 앱이나 편집 도구의 번들 통합으로 가능합니다. 파라미터 제어와 초당 과금을 크레딧 잔액과 남의 프리셋으로 맞바꾸는 것입니다.
2.0과 2.5에 각각 다른 키가 필요합니까? 아닙니다. 둘 다 제공하는 플랫폼은 같은 계정, 같은 키 아래에서 서로 다른 모델 식별자로 노출합니다. 버전 전환은 대개 문자열 하나를 바꾸는 일입니다.
첫 영상이 나오기까지 얼마나 걸립니까? 요청이 수락된 뒤 2~5분입니다. 생성 호출 자체는 1초도 안 되어 작업 id와 함께 반환되는데, 응답에서 영상을 기대하던 사람들을 헷갈리게 만드는 부분이 바로 이것입니다.
실패한 생성도 과금됩니까? 아닙니다. 실패는 거부를 포함해 전액 환불됩니다. 완료된 작업의 크레딧 수치를 확인해 선점분이 돌아왔는지 확인하십시오.
한 줄 요약
Seedance 2.0 이용 방법은 세 가지 결정과 한 번의 요청입니다. 창구를 고르되, 소비자용 앱은 버전과 상한을 감추고 API 키는 둘 다 드러낸다는 점을 알고 고르십시오. 키를 받아 서버 쪽에 두고, 레퍼런스 이미지는 공개 URL에 올려 두십시오. 모델 문자열, 프롬프트, 15초 이하의 길이, 해상도를 담아 POST를 보내고 2~5분 동안 폴링하십시오. 첫 번째는 480p 5초로 하십시오. 몇 센트면 되고, 실패하면 환불됩니다.


