Seedance 2.5 API 퀵스타트: Atlas Cloud로 첫 비디오 생성하기

Seedance 2.5 발표를 읽고, 30초 길이의 생성된 클립을 중심으로 제품 기능을 스케치했으며, 이제 코드를 작성하고 싶을 것입니다. 하지만 새로 발표된 모델을 접하는 모든 개발자가 겪는 벽에 부딪힙니다. 기능 페이지는 활성화되어 있지만, 앱에서 실제로 호출할 수 있는 엔드포인트는 완전히 다른 문제입니다.

여기에 상황에 대한 솔직한 버전과 이를 존중하는 퀵스타트가 있습니다. Atlas Cloud는 Seedance 2.5 제품군 페이지를 게시하여 이미 Seedance 2.0 및 1.5를 제공하는 동일한 통합 엔드포인트에서 Day-0 액세스를 약속했습니다. 이 글을 쓰는 시점에는 해당 목록이 '출시 예정'으로 표시되어 있으며 Seedance 2.5에 대한 Atlas Cloud 가격은 아직 발표되지 않았습니다. 실질적으로 좋은 소식은 다음과 같습니다. 오늘 라이브 Seedance 티어에 대해 구축하는 통합은 2.5 출시 시 실행할 통합과 동일합니다. 변경되는 유일한 것은 모델 문자열입니다.

따라서 이 퀵스타트는 두 가지 작업을 수행합니다. 오늘 실제 엔드포인트에서 실제 비디오를 가져오고, 코드를 구성하고 프롬프트를 작성하여 업그레이드가 한 줄의 차이로 이루어지도록 합니다.

Seedance 2.5에 실제로 포함되는 내용

ByteDance의 공식 Seedance 2.5 페이지에 따르면, 이 모델은 정밀한 참조 제어 및 강력한 편집 기능을 갖춘 30초 스토리텔링을 위해 구축된 차세대 오디오-비디오 공동 생성 모델입니다. 설계에 고려할 만한 구체적인 주장은 다음과 같습니다.

• 단일 생성으로 최대 30초, 더 길고 완전한 스토리텔링을 위해 두 번 확장 가능
• 더 부드럽고 일관된 움직임, 더 사실적인 시각 효과
• 더 정밀한 참조 비디오 이해, 단순히 움직임을 전달하는 것이 아니라 의도, 프레이밍 및 영화적 언어 포착
• 더 넓은 범위의 오디오 및 시각적 편집 요청에 대한 더 안정적인 편집
• 화이트 모델 제어 및 그린 스크린 편집, 전문적인 카메라 움직임 및 연기 블로킹, 복잡한 제작 워크플로우를 목표로 함

목록에 없는 내용에 주목하세요. 벤치마크 테이블, 해상도 계층, 참조 자산 개수는 없습니다. 이와 관련하여 보신 내용은 누군가의 마케팅 포장이며, 1차 사양 시트가 아닙니다. 위 주장을 바탕으로 구축하세요.

1단계: 콘솔에서 키 가져오기

console.atlascloud.ai에 로그인하여 API 키를 생성하세요. 보증금, 최소 약정, 대기 목록이 없으므로 키는 종량제 방식으로 즉시 사용할 수 있습니다. 하나의 키는 텍스트, 이미지, 비디오를 포함한 300개 이상의 모델 전체 카탈로그를 하나의 청구 계정으로 커버하며, 이는 이 퀵스타트에서 중요한 부분입니다. 지금 생성하는 키는 Seedance 2.5를 호출할 키와 동일합니다.

소스에 저장하지 말고 환경 변수로 저장하세요. ATLASCLOUD_API_KEY는 좋은 이름입니다.

2단계: 비디오 작업 제출

Atlas Cloud의 비디오 생성은 채팅 완성이 아닌 두 단계의 비동기 REST 호출입니다. 작업을 POST하고 예측 ID를 받은 다음, 렌더링이 완료될 때까지 해당 ID를 폴링합니다. 모든 HTTP 클라이언트가 작동하므로 설치할 공급업체 SDK나 배울 새로운 인증 체계가 없습니다. 방금 생성한 키에 대한 베어러 토큰입니다.

pythonCopy
1import os, time, requests
2
3KEY  = os.environ["ATLASCLOUD_API_KEY"]
4BASE = "https://api.atlascloud.ai/api/v1/model"
5HEAD = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"}
6
7job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={
8    "model": "bytedance/seedance-2.0/text-to-video",
9    "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, "
10              "neon reflections on wet asphalt, slight lag on turns.",
11    "duration": 5,
12    "resolution": "720p",
13    "ratio": "adaptive",
14    "bitrate_mode": "standard",
15    "generate_audio": True,
16    "watermark": False,
17}).json()
18
19prediction_id = job["data"]["id"]

응답은 {"code": 200, "data": {"id": "...", "status": "processing"}}으로 돌아옵니다. model이 일반 문자열 필드라는 점에 유의하세요. 이 세부 사항은 이 기사의 전체 업그레이드 스토리이며, 6단계에서 다시 다룹니다.

3단계: 렌더링이 완료될 때까지 폴링

5초 클립은 즉각적인 응답이 아니므로 렌더링을 차단 호출이 아닌 수명 주기를 가진 작업으로 취급하세요. status가 터미널 값에 도달할 때까지 예측 엔드포인트를 폴링합니다.

pythonCopy
1while True:
2    r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json()
3    status = r["data"]["status"]
4    if status in ("completed", "succeeded", "failed"):
5        break
6    time.sleep(3)
7
8print(status, r["data"])   # on success the payload carries the output URL(s)

나중에가 아니라 지금 구축할 가치가 있는 두 가지가 있습니다. 폴링 루프에 상한선을 두어 멈춘 작업이 요청 핸들러를 중단시키지 않도록 하고, 폴링을 시작하기 전에 예측 ID를 유지하여 충돌한 작업자가 렌더링 비용을 두 번 지불하는 대신 재개할 수 있도록 합니다. 두 습관 모두 2.5로 변경 없이 이어집니다.

기능이 순수 텍스트 대신 참조 이미지 또는 주제 참조에서 작동하는 경우, bytedance/seedance-2.0/image-to-video 또는 bytedance/seedance-2.0/reference-to-video와 같은 다른 모델 변형에 동일한 흐름이 적용됩니다. 주제 참조 자산은 uploadMedia를 통해 한 번 업로드된 다음 이미지 필드에 asset://<id>로 전달되므로 반복되는 캐릭터나 제품을 모든 호출에서 다시 업로드할 필요가 없습니다.

4단계: 라이브 Seedance 티어 선택 및 초당 비용 파악

Atlas Cloud는 출력 비디오의 초당 요금을 청구합니다. 이는 코드를 작성하기 전에 머리로 계산할 수 있는 산술입니다. 현재 세 가지 Seedance 티어가 라이브 상태입니다.

참고로, 동일한 키에서 실행되는 다른 비디오 모델은 비슷한 범위에 있습니다. Grok Imagine Video v1.5는 $0.080/s, Wan 2.7은 $0.100/s, Kling V3.0 Turbo는 표준 $0.112, 할인 $0.095, MiniMax H3는 $0.14/s입니다.

어떤 모델을 기반으로 구축할지는 2.5 기능이 궁극적으로 무엇을 할지에 따라 달라집니다. 오디오가 출력의 핵심이라면 Seedance 1.5 Pro는 이미 네이티브 동기화 오디오와 다국어 립싱크를 지원하는 티어이므로 파이프라인이 처음부터 오디오 트랙을 처리하는 방법을 배웁니다. 프롬프트 구조를 반복하고 실험당 가장 낮은 비용을 원한다면 $0.056/s의 Seedance 2.0 Mini가 명백한 샌드박스입니다. 프로덕션 등급의 현재 세대 렌더링에 가장 가까운 것을 원한다면 $0.112/s의 Seedance 2.0이 간단한 선택이며, 처리량이 품질의 마지막 증분보다 더 중요하다면 $0.09/s의 Fast 변형이 있습니다.

5단계: 지출하기 전에 Playground에서 실시간 가격 확인

첫 유료 호출 전에 Atlas Cloud Playground에서 모델을 엽니다. 각 모델은 실행 버튼 옆에 실시간 모델당 가격을 표시합니다. 이는 생각보다 중요합니다. 프로모션 할인은 오고 가며, 실행 버튼 옆의 숫자가 실제로 청구될 금액입니다. Playground에서 한 번 생성하고, 출력이 기능에 필요한 것인지 확인한 다음, 설정을 코드로 포팅합니다.

출력 초당 모델은 예산 대화를 사소하게 만듭니다. Seedance 2.0 Mini에서 10초 클립은 10 × $0.056입니다. 계산기, 토큰 추정치, 사후 조정 단계가 없습니다.

이는 1차 ByteDance 채널이 Seedance를 청구하는 방식과 대조할 가치가 있습니다. 중국의 Volcano Engine Ark와 국제적으로 BytePlus ModelArk에서는 토큰 기반으로 청구됩니다. 예상 토큰 소비량은 (입력 비디오 길이 + 출력 비디오 길이) × 출력 너비 × 출력 높이 × 출력 프레임 속도 / 1024에 토큰 단위 가격을 곱한 값이며, API 응답의 usage.completion_tokens 필드에서 실제 사용량이 권한을 가집니다. Seedance 2.0 시리즈 및 Seedance 2.5의 경우, 입력에 비디오가 포함될 때 최소 토큰 소비량이 적용되며, 이 최소값은 해상도, 종횡비 및 출력 길이에 따라 달라집니다. ByteDance는 바로 이러한 이유로 가격 계산기와 최소 토큰 테이블을 게시합니다.

두 모델 모두 합법적입니다. 하지만 30초 렌더링 예산을 책정하는 경우, 출력 초당은 암산이고, 최소값이 있는 토큰은 스프레드시트가 필요합니다.

6단계: 이미 2.5인 것처럼 샷 설명 작성

이것은 프롬프트 작성이 버전 관리되지 않으므로 완벽하게 전달되는 퀵스타트의 부분입니다. 2.5 기능 주장 중 두 가지는 오늘 작성하는 방식에 영향을 미쳐야 합니다.

정밀한 참조 제어. ByteDance의 주장은 2.5가 움직임 전달을 넘어 의도, 프레이밍 및 영화적 언어를 위해 참조 비디오를 읽는다는 것입니다. 프롬프트 작성의 의미는 참조 자산이 움직임 템플릿이 아니라 연출 지시서가 된다는 것입니다. 따라서 피사체만 설명하는 프롬프트 작성을 중단하고, 전달하려는 문법(렌즈 느낌, 프레이밍, 컷의 페이싱, 카메라가 피사체를 이끄는지 따르는지)을 명시하기 시작하세요. '사람이 걷는, 영화 같은' 대신 '핸드헬드, 피사체 추적 미디엄 샷, 야시장 사이를 누비는 택배 기사, 젖은 아스팔트에 네온 반사, 회전 시 약간의 지연'과 같이 작성하세요.

단일 생성으로 30초. 5초 클립은 한 샷입니다. 30초는 구조가 있는 장면이며, 2.5는 그 위에 두 번 확장을 지원합니다. 따라서 단일 정적 설명 대신 비트 구조로 샷 설명을 작성하세요. 설정 비트, 변화(회전, 입장, 공개), 그리고 해결. 카메라 움직임과 연기 블로킹을 명시적으로 지정하세요. 이는 2.5가 목표로 하는 정확한 제어이기 때문입니다. 피사체가 서 있는 곳, 움직이는 곳, 피사체가 움직이는 동안 카메라가 하는 일.

두 습관 모두 현재 라이브 티어에서 효과를 발휘합니다. 두 습관 모두 2.5가 보상하는 정확한 습관입니다.

7단계: 교체 계획

모델 식별자가 리터럴이 아닌 구성이 되도록 코드를 구성하세요. 환경 또는 구성에서 읽는 하나의 상수:

pythonCopy
1SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")

그런 다음 2단계에서 문자열을 하드코딩한 곳에 SEEDANCE_MODEL을 전달합니다. generateVideo 본문에서 model이 단일 JSON 문자열 필드이므로, 2.5 출시 시 업그레이드는 실제로 하나의 환경 변수입니다. 작은 변화에 대한 은유가 아니라 말 그대로 하나의 값입니다.

오늘 Seedance 2.5 식별자를 하드코딩하지 마세요. 아직 Atlas Cloud Seedance 2.5 모델 ID가 존재하지 않기 때문입니다. 새로운 변형이 시간이 지남에 따라 추가되므로, 이 기사를 포함한 어떤 기사에서도 복사하지 말고 atlascloud.ai/models에서 정확한 라이브 ID를 가져오세요. 2.5가 Day-0 약속에 따라 출시되면, 귀하 측의 작업은 해당 변수 하나와 실행 버튼 옆의 가격을 새로 확인하고 새로운 요청 매개변수를 다시 읽는 것입니다. 30초 모델은 확장 지원과 함께 2.0 본문에는 없는 필드를 수락할 수 있기 때문입니다.

한편, Atlas Cloud 출시가 아닌 지금 Seedance 2.5가 필요하다면, 솔직한 답변은 1차 ByteDance 채널입니다. 중국의 Volcano Engine Ark와 국제적으로 BytePlus ModelArk입니다. 애그리게이터 중 일부는 동일한 사전 출시 또는 Day-0 약속 상태에 있습니다.

FAQ

Q: 지금 Atlas Cloud에서 Seedance 2.5를 호출할 수 있나요? A: 아니요. Atlas Cloud의 Seedance 2.5 제품군 페이지는 '출시 예정'으로 표시되어 있으며, Seedance 2.0 및 1.5를 이미 제공하는 동일한 통합 엔드포인트에서 Day-0 액세스를 약속합니다. 아직 모델 ID와 가격이 발표되지 않았습니다.

Q: 오늘 Atlas Cloud에서 Seedance 비용은 얼마인가요? A: Seedance 2.0은 $0.112/s, Seedance 2.0 Fast는 $0.09/s, Seedance 2.0 Mini는 $0.056/s, Seedance 1.5 Pro는 $0.047/s 또는 Fast 변형에서 $0.018/s입니다. 청구는 출력 길이의 초당이며, 실시간 가격은 Playground의 실행 버튼 옆에 표시됩니다.

Q: Atlas Cloud에서 비디오를 사용하려면 특별한 SDK가 필요한가요? A: 아니요. 비디오는 일반 REST 흐름입니다. POST /api/v1/model/generateVideo로 작업을 제출하고, GET /api/v1/model/prediction/{id}로 폴링하며, 둘 다 Atlas Cloud 키의 베어러 토큰으로 인증됩니다. 모든 HTTP 클라이언트가 작동합니다. 비디오는 텍스트 카탈로그에서 사용하는 OpenAI 호환 채팅 엔드포인트를 통과하지 않으므로 chat.completions가 클립을 렌더링할 것으로 기대하지 마세요. 모델별 요청 매개변수는 atlascloud.ai/docs에 문서화되어 있습니다.

Q: 시작하려면 보증금이나 최소 약정이 필요한가요? A: 아니요. Atlas Cloud는 보증금, 최소 약정, 대기 목록 없이 종량제 방식이며, console.atlascloud.ai에서 받은 키는 즉시 사용할 수 있습니다.

Q: 2.5를 목표로 한다면 어떤 라이브 티어에서 프로토타입을 만들어야 하나요? A: 저렴한 프롬프트 반복을 위해 $0.056/s의 Seedance 2.0 Mini, 파이프라인이 네이티브 동기화 오디오 트랙을 처리해야 한다면 Seedance 1.5 Pro, 가장 가까운 현재 세대 프로덕션 렌더링을 위해 $0.112/s의 Seedance 2.0입니다.

결론

Atlas Cloud는 오늘 하나의 API 키로 Seedance 2.0, Seedance 2.0 Fast, Seedance 2.0 Mini 및 Seedance 1.5 Pro를 실행하며, 출력 길이에 따른 초당 청구, SOC II 인증, HIPAA 준수, 저장 및 전송 중 암호화를 제공합니다. 또한 Seedance 2.5가 출시될 때 동일한 통합 엔드포인트에서 제공하겠다는 Day-0 약속을 발표했습니다.