ByteDance: Seedance 2.0
ByteDance Seedance 2.0은 기본 오디오·영상 생성과 이미지, 영상, 소리 참조를 결합합니다. 새 장면을 연출하고 기존 영상을 편집하거나 시퀀스를 확장할 수 있습니다. 표준 버전에는 문서에 명시된 1080p 및 10비트 4K 출력이 포함됩니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Seedance 2.0은 멀티모달 오디오·영상 제작을 위한 ByteDance Seed의 표준 모델입니다. 공동 생성 구조에서 텍스트, 이미지, 영상, 오디오를 결합하며 참조 중심 장면, 영상 편집, 영상 확장을 별도의 제작 워크플로로 제공합니다. 일관된 연기와 준비된 자료의 구체적인 시각·소리 정보가 모두 필요한 요구사항에 유용합니다.
멀티모달 참조와 연출 제어
이미지는 피사체의 외형, 시각 스타일, 구도를 정의할 수 있습니다. 영상 참조는 행동, 카메라 움직임, 효과를 유도하고 오디오는 음색, 음악, 대화를 유도할 수 있습니다. 각 자료의 역할을 정의한 뒤 만들어야 할 장면을 설명하세요. 제조사는 연기, 조명, 그림자, 카메라 표현에 대한 제어를 강조합니다.
제품 이야기에는 제품 사진, 카메라 움직임 참조, 오디오 신호를 준비하세요. 예를 들어 “Image 1의 파란 유리 화병을 보존하세요. Video 1의 느린 수평 트래킹을 사용하세요. 화병은 햇빛이 드는 선반에 있으며 Audio 1을 바탕으로 한 부드러운 연주 음악이 흐릅니다.”라고 쓸 수 있습니다. 의도한 출력은 선택한 참조 정보를 결합해 새로 연출한 장면입니다.
참조 입력은 이미지와 오디오, 이미지와 영상, 영상과 오디오, 세 가지 모두를 결합할 수 있습니다. 오디오만 입력하거나 이미지·영상 없이 텍스트와 오디오만 입력하는 것은 지원되지 않습니다. 기존의 텍스트 영상 변환, 첫 프레임 생성, 첫·마지막 프레임 생성도 문서화되어 있습니다. 고정된 시작과 종료 구도가 중요하면 전용 끝점 워크플로를 사용하세요. omni-reference 프롬프트 안에서 참조 이미지를 끝점이라고 명명하는 것은 간접적인 유도일 뿐입니다.
영상 편집
모델은 피사체를 교체하고 물체를 추가·제거하며 요소를 바꾸고 영상 일부를 다시 그리거나 복구할 수 있습니다. 구체적인 변경을 설명하고 원본 영상을 식별하세요. 추가에는 등장 시간과 위치를 포함하고 제거·교체에는 물체를 정확히 명시하며 남아야 할 것을 지정하세요.
예를 들어 “Video 1의 책상 램프를 Image 1의 황동 램프로 교체하세요. 카메라 움직임, 책상 배치, 조명 방향을 유지하세요.”라고 쓸 수 있습니다. 원하는 결과는 의도한 대체를 적용한 장면의 편집본입니다. 특히 가림, 움직임, 숏 전환을 거치며 새 물체와 바뀌지 않은 영역을 모두 살피세요.
시퀀스 확장과 연결
Seedance 2.0은 영상을 앞뒤로 확장하고 최대 세 개의 입력 클립을 생성 전환으로 연결할 수 있습니다. 시간 방향과 새 사건을 지정하세요. 연결에서는 클립 순서를 정하고 한 숏의 카메라가 문으로 들어가 다음 환경에 도착하는 것처럼 각 쌍 사이의 전환을 설명하세요.
단순 확장은 보통 원본 주변에서 전개한 이어지는 부분을 반환합니다. 최종 결과에 원래 구간도 반복되어야 하면 명확히 지시하세요. 두세 클립의 연결을 완성할 때 문서상의 워크플로는 원본 자료와 새 전환 내용을 모두 포함할 수 있습니다. 이는 시작이나 결말을 발전시키거나 연결 동작을 지정하지 않은 채 남기지 않고 준비된 장면을 잇는 데 유용합니다.
표준 버전 출력과 4K
표준 버전은 24 fps MP4와 4~15초 길이를 문서화합니다. 출력 수준은 8비트 색 깊이의 480p, 720p, 1080p와 10비트 색 깊이의 4K입니다. 지원 비율은 21:9, 16:9, 4:3, 1:1, 3:4, 9:16입니다. 적응형 프레이밍과 자동 길이 선택도 명시되어 있습니다. Fast 버전에는 더 좁은 자체 480p/720p 출력 규격이 있습니다.
4K 출력은 H.265/HEVC 인코딩을 사용합니다. 10비트 인코딩은 더 많은 명암 단계와 부드러운 색 전환을 보존하며 섬세한 빛이나 색 그라데이션이 있는 자료에 중요합니다. 의도한 재생·편집 환경이 해당 형식을 디코딩할 수 있는지 확인하세요. 일부 브라우저와 기기는 직접 재생하지 못합니다. 호환되는 컨테이너만으로 영상 디코딩 호환성이 보장되지는 않습니다.
모델은 동기화된 소리나 무음 영상을 생성할 수 있고 이후 장면에 사용할 마지막 생성 프레임을 반환할 수 있습니다. 생성 오디오는 모노입니다. 2.0 계열은 별도의 2단계 Draft 미리보기 모드를 지원하지 않습니다. 다른 Seedance 버전에서 해당 미리보기 기능을 추정해서는 안 됩니다.
참조 준비와 실질적 한도
문서상의 참조 용량은 이미지 최대 9개, 영상 3개, 오디오 클립 3개입니다. 이 제작사 규격은 실제 사람 얼굴을 포함한 참조 이미지·영상의 직접 업로드를 받지 않으며 인물 작업은 지원되는 인물 자산 워크플로를 사용합니다. 각 영상·오디오 클립은 2~15초여야 합니다. 모든 영상 참조 합계는 15초 이내여야 하며 모든 오디오 참조에는 별도의 총 15초 한도가 있습니다. 영상 파일은 MP4 또는 MOV, 24~60 fps, 각각 최대 200 MB이며 오디오는 WAV 또는 MP3, 각각 최대 15 MB입니다. 이미지 형식은 JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF입니다. 각 이미지는 30 MB 미만, 요청 본문은 64 MB 이하여야 합니다. 문서상의 참조 입력 규격에서 이미지 너비와 높이는 각각 300픽셀보다 크고 6,000픽셀보다 작아야 하며 가로세로 비율은 0.4보다 크고 2.5보다 작아야 합니다. 참조 영상은 경계값을 포함해 각 변 300~6,000픽셀, 비율 0.4~2.5, 총픽셀 수 407,696~8,295,044를 허용합니다. MP4 또는 MOV 영상은 H.264/AVC 또는 H.265/HEVC 영상과 AAC 또는 MP3 오디오를 사용합니다.
파일을 의도적으로 정렬하고 Image 1, Video 1, Audio 1처럼 미디어 유형과 번호로 참조하세요. 번호는 같은 유형 파일 사이의 순서를 따릅니다. 전달할 특성과 새 장면을 정의해서는 안 되는 원본 내용을 설명하세요. 문서상의 프롬프트 언어에는 영어, 스페인어, 인도네시아어, 포르투갈어, 일본어가 있습니다. 대화 안의 발화 언어를 일관되게 유지하세요. 안내는 고유명사를 제외한 언어 혼합을 피하도록 권장합니다. 목소리로 유도하는 작업에서는 화자, 정확한 대사, 표현 지시를 분리하세요.
첫 이미지와 마지막 이미지는 서로 맞는 프레이밍으로 준비하세요. 입력 사진과 출력 크기의 불일치는 자르기나 급격한 시각 변화를 일으킬 수 있습니다. 일치하는 크기와 적응형 프레이밍이 문서상의 해결책입니다. 설명을 사건과 참조 역할에 집중하세요. 제조사는 긴 프롬프트가 정보를 분산시켜 세부가 무시될 수 있다고 경고합니다. 생성 움직임, 참조 연속성, 오디오 연기, 장면 접합부를 제작 결과의 개별 요소로 검토하세요.
숏 계획과 텍스트 지시
복잡한 장면은 Shot 1, Shot 2, Shot 3으로 구성하고 카메라, 피사체 행동, 위치, 소리를 순서대로 지정하세요. 안내는 숏당 카메라 움직임 하나와 느리고 연결된 행동을 우선하도록 권장합니다. 정확한 숏별 타임스탬프는 불안정하므로 여러 정밀한 시간 창을 강제하기보다 사건 순서로 제어하는 것이 낫습니다.
모델은 슬로건, 자막, 말풍선 같은 일반 텍스트도 생성합니다. 텍스트의 색, 시각적 처리, 위치, 등장을 지시할 수 있습니다. 희귀 문자나 특수 기호 대신 일반 문자를 사용하고 움직이는 동안 문구를 검토하세요. 피사체 참조에서는 자산마다 의도한 캐릭터나 물체를 명확히 연결하세요. 제품의 각 시점은 서로 다른 시각 정보를 제공할 수 있고 캐릭터 턴어라운드 콜라주는 얼굴 정체성을 혼동시킬 수 있습니다. 명확한 얼굴 사진과 전신 이미지를 분리하는 것이 문서화된 캐릭터 참조 권장사항입니다.
편집 전에 살펴볼 동작
안내는 원치 않는 자막, 로고, 중복 캐릭터, 스타일 변화를 설명합니다. 깨끗한 원본 자료, 일관된 라벨, 명시적 제약은 위험을 줄이지만 원치 않는 텍스트나 중복 인물이 사라진다고 보장하지는 않습니다. 참조 인물이 4명을 넘는 것은 안정성 위험으로 보고되며 모델이 받는 파일 수와 별개입니다.
영상 확장은 접합부에서 화면이 뛰거나 되돌아가게 할 수 있고 반복적인 이어 만들기는 화질 저하를 누적시킬 수 있습니다. 경계 프레임을 살피고 확장을 지나치게 쌓지 마세요. 참조 목소리가 원본 음색과 다를 수 있고 내레이션이 클릭음이나 급격한 잘림으로 끝날 수 있습니다. 이 경우 오디오 페이드가 문서화된 해결책입니다. 중국어 다음자, 드문 문자, 모양이 비슷한 문자는 잘못 발음될 수 있습니다. 카운트다운 같은 정밀한 애니메이션 효과에는 말로만 요청하는 것보다 움직임 참조가 더 유익합니다. 이는 클립을 선택할 때 정체성, 텍스트, 움직임, 소리를 따로 확인해야 하는 구체적인 이유입니다.
Ailoot Ultra · 동영상 POST /v1/videos bytedance/seedance-2.0
bytedance/seedance-2.0시작하기
ByteDance Seedance 2.0은 기본 오디오·영상 생성과 이미지, 영상, 소리 참조를 결합합니다. 새 장면을 연출하고 기존 영상을 편집하거나 시퀀스를 확장할 수 있습니다. 표준 버전에는 문서에 명시된 1080p 및 10비트 4K 출력이 포함됩니다.
- 허용 입력
- 텍스트 · 이미지 · 오디오
- 결과
- 동영상
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 동영상 POST /v1/videos
- 입력
text,image,audio- 출력
video- 출력 형식
- 원본 MP4 바이트(정규화·트랜스코딩 없음)
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 bytedance/seedance-2.0 | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드duration | 유형integer | 요건필수 | 값과 한도 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 최솟값: 1 최댓값: 600 | 기본값— |
필드resolution | 유형string | 요건선택 사항 | 값과 한도 480p, 720p, 1080p, 4K | 기본값— |
필드aspect_ratio | 유형string | 요건선택 사항 | 값과 한도 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | 기본값— |
필드generate_audio | 유형boolean | 요건선택 사항 | 값과 한도 false, true 조건: 480p와 720p에서 generate_audio를 생략하면 오디오 포함 요금이 선택되고, false로 설정하면 오디오 제외 요금이 선택됩니다. 1080p와 4K에서는 두 설정 모두 해당 해상도 요금이 적용됩니다. 반환된 오디오 트랙은 결과의 has_audio로 확인하세요. | 기본값— |
필드frame_images | 유형array | 요건선택 사항 | 값과 한도 최소 항목 수: 1 최대 항목 수: 2 입력 콘텐츠: 프레임 객체 배열입니다. 각 객체에는 type=image_url, url을 포함하는 image_url 및 frame_type=first_frame 또는 last_frame이 있습니다. 각 역할은 최대 한 번만 나타날 수 있습니다. 공개 HTTPS URL을 사용하세요. 정확한 키: type, image_url, frame_type 조건: 이 키는 각 프레임 객체에 적용됩니다. 텍스트만 사용하는 요청에서는 frame_images를 생략하세요. | 기본값— |
필드input_references | 유형array | 요건선택 사항 | 값과 한도 입력 콘텐츠: 이미지 또는 오디오 참조 객체의 배열입니다. type을 image_url 또는 audio_url로 설정하고 url을 포함하는 해당 URL 객체를 제공하세요. 동영상 참조 자료는 여전히 요금을 계산할 수 없습니다. 조건: 참조 모드를 사용하려면 frame_images를 생략하세요. 공개 HTTPS URL을 사용하세요. | 기본값— |
필드size | 유형string | 요건선택 사항 | 값과 한도 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720, 1080x1080, 1080x1440, 1080x1920, 1440x1080, 1920x1080, 2520x1080, 3840x2160, 2160x3840, 2160x2160, 2880x2160, 2160x2880, 5040x2160 패턴: ^[1-9][0-9]*x[1-9][0-9]*$ | 기본값— |
필드seed | 유형integer | 요건선택 사항 | 값과 한도 최솟값: -9,223,372,036,854,775,808 최댓값: 9,223,372,036,854,775,807 | 기본값— |
필드callback_url | 유형string | 요건선택 사항 | 값과 한도 패턴: ^https:// | 기본값— |
필드session_id | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
필드trace | 유형object | 요건선택 사항 | 값과 한도 | 기본값— |
필드user | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
입력 자료 조합
텍스트로 동영상 생성 · 작성한 프롬프트입니다. · 필수: model, prompt, duration
텍스트 프롬프트와 지원되는 정수 단위 초의 길이를 제공하세요. 나열된 정확한 크기 또는 나열된 치수로 결정되는 해상도와 화면 비율을 사용하세요.
model: 유형: string · bytedance/seedance-2.0
prompt: 유형: string · 최대 UTF-8 바이트 수: 10,000 · 공백이 아닌 문자 필수: 예
이미지로 동영상 생성 · 작성한 프롬프트와 프레임 이미지입니다. · 필수: model, prompt, duration, frame_images
frame_images는 type=image_url, url을 포함하는 image_url 및 frame_type이 있는 객체 배열입니다. 공개 HTTPS 이미지 URL을 사용하세요. first_frame과 last_frame은 각각 한 번만 나타날 수 있습니다. 나열된 출력 크기 또는 호환되는 크기를 사용하세요. 동영상 참조 자료를 추가하지 마세요.
정확한 키: type, image_url, frame_type
model: 유형: string · bytedance/seedance-2.0
prompt: 유형: string · 최대 UTF-8 바이트 수: 10,000 · 공백이 아닌 문자 필수: 예
Reference to video · 작성한 프롬프트와 이미지 또는 오디오 참조 자료입니다. · 필수: model, prompt, duration, input_references
input_references는 배열입니다. 각 객체에는 type=image_url 또는 type=audio_url과 url을 포함하는 해당 URL 객체가 있습니다. 공개 HTTPS 링크를 사용하세요. 참조 모드를 선택하려면 frame_images를 생략하세요. 동영상 참조 자료는 요금을 계산할 수 없습니다.
model: 유형: string · bytedance/seedance-2.0
prompt: 유형: string · 최대 UTF-8 바이트 수: 10,000 · 공백이 아닌 문자 필수: 예
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, prompt, duration |
매개변수material_types | 명세text, image, audio |
매개변수additional_properties | 명세false |
매개변수optional_controls | 명세resolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
수명 주기: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
요금
최종 요금 계산 방식
표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
비교용 예상 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 예측 수량 | 과금 단위 | 과금 조건 | 요금 |
|---|---|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 예측 수량— | 과금 단위— | 과금 조건— | 요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰 |
| 설정동영상 토큰 요금 | 요금표— | 예측 수량— | 과금 단위1K 동영상 토큰당 | 과금 조건이 가격 키에는 추가 조건이 명시되어 있지 않습니다. | 요금 출력 · 동영상 토큰 가격 · 비교 전용 추정치 $0.014 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 요금표— | 예측 수량— | 과금 단위1K 동영상 토큰당 | 과금 조건resolution: 1080p | 요금 출력 · 동영상 토큰 가격 · 비교 전용 추정치 $0.0154 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 요금표— | 예측 수량— | 과금 단위1K 동영상 토큰당 | 과금 조건입력: with_video_input; 해상도: 1080p | 요금 reference · 동영상 토큰 가격 · 비교 전용 추정치 $0.0094 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 요금표— | 예측 수량— | 과금 단위1K 동영상 토큰당 | 과금 조건resolution: 4k | 요금 출력 · 동영상 토큰 가격 · 비교 전용 추정치 $0.008 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 요금표— | 예측 수량— | 과금 단위1K 동영상 토큰당 | 과금 조건입력: with_video_input; 해상도: 4k | 요금 reference · 동영상 토큰 가격 · 비교 전용 추정치 $0.0048 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 요금표— | 예측 수량— | 과금 단위1K 동영상 토큰당 | 과금 조건입력: with_video_input | 요금 reference · 동영상 토큰 가격 · 비교 전용 추정치 $0.0086 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 요금표— | 예측 수량— | 과금 단위1K 동영상 토큰당 | 과금 조건오디오: without_audio | 요금 출력 · 동영상 토큰 가격 · 비교 전용 추정치 $0.014 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정예상 생성 비용 | 요금표— | 예측 수량1회 생성 예상치 | 과금 단위— | 과금 조건— | 요금 출력 · 예상 생성 비용 · 비교 전용 추정치 $0.3024 생성 전 추정치 이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다. |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
참조 요금 상세 정보
모델 수준의 참조 요금표는 메서드 선택, 견적 또는 요금을 변경하지 않습니다. 실제 과금에는 선택한 Ailoot 메서드 요금이 적용됩니다.
동영상 설정별 요금 참조
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 과금 조건 | 요금 |
|---|---|---|
| 설정동영상 토큰 요금 | 과금 조건이 가격 키에는 추가 조건이 명시되어 있지 않습니다. | 요금 출력 · 동영상 토큰 가격 $0.014 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 과금 조건resolution: 4k | 요금 출력 · 동영상 토큰 가격 $0.008 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 과금 조건resolution: 1080p | 요금 출력 · 동영상 토큰 가격 $0.0154 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 과금 조건오디오: without_audio | 요금 출력 · 동영상 토큰 가격 $0.014 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 과금 조건입력: with_video_input | 요금 reference · 동영상 토큰 가격 $0.0086 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 과금 조건입력: with_video_input; 해상도: 4k | 요금 reference · 동영상 토큰 가격 $0.0048 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 과금 조건입력: with_video_input; 해상도: 1080p | 요금 reference · 동영상 토큰 가격 $0.0094 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
요청 예제
Ailoot Ultra · 동영상
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
결과 수신 및 저장
Ailoot Ultra · 동영상
소유한 콘텐츠의 서명된 URL
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
작업 상태 확인
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
기타 콘텐츠 조회
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
완료된 결과 모두 보관
완료된 모든 동영상과 반환된 파일을 저장하고, 실제로 반환된 모든 자산 URL에서 가져오세요.
실제로 소유한 모든 출력과 함께 반환된 측정 메타데이터를 보존하세요.
원래 응답을 확인해야 할 경우
503 result_pending_check + 원래 id + X-Should-Retry:false; 원래 요청을 절대로 재전송하지 마세요.
응답 필드
| 필드 | 유형 | 의미 |
|---|---|---|
필드index | 유형integer | 의미출력 목록에서 이 동영상의 영부터 시작하는 위치입니다. |
필드content_url | 유형string | 의미완료된 이 동영상의 서명된 HTTPS 다운로드 URL입니다. |
필드sha256 | 유형string | null | 의미원본 동영상 바이트의 SHA-256 다이제스트입니다. 확인할 수 없으면 null입니다. |
필드size_bytes | 유형integer | null | 의미바이트 단위 원본 동영상 파일 크기입니다. 확인할 수 없으면 null입니다. |
필드duration_ms | 유형integer | null | 의미밀리초 단위로 측정한 동영상 길이입니다. 확인할 수 없으면 null입니다. |
필드width | 유형integer | null | 의미픽셀 단위 동영상 너비입니다. 확인할 수 없으면 null입니다. |
필드height | 유형integer | null | 의미픽셀 단위 동영상 높이입니다. 확인할 수 없으면 null입니다. |
필드video_codec | 유형string | null | 의미동영상 코덱 식별자입니다. 기록되지 않았으면 null입니다. |
필드has_audio | 유형boolean | null | 의미동영상에 오디오 트랙이 포함되어 있는지 나타냅니다. 측정하지 않았으면 null입니다. |
필드audio_codec | 유형string | null | 의미오디오 코덱 식별자입니다. 식별자가 기록되지 않았으면 null입니다. |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답404 · not_found_error | 조건동영상에 접근할 수 없거나 해당 동영상 ID를 찾지 못했습니다. | 다음 단계동영상 접근 권한을 확인하세요. 기존 동영상에는 원래 공개 ID와 동일한 API 키를 사용하세요. |
응답401 · authentication_error | 조건API 키가 인증된 계정과 일치하지 않습니다. | 다음 단계제출 전에 API 키와 계정 접근 권한을 확인하세요. |
응답400 · invalid_request_error | 조건요청을 읽을 수 없거나 다운로드 인덱스가 유효하지 않습니다. | 다음 단계요청 본문을 수정하세요. 다운로드할 때는 원래 작업에서 반환된 출력 인덱스를 선택하세요. |
응답422 · price_unavailable | 조건선택한 동영상 설정의 요금을 계산할 수 없습니다. | 다음 단계지원되는 동영상 설정을 선택하고 필수 옵션을 모두 지정한 뒤 수정된 요청을 제출하세요. |
응답422 · invalid_request_error | 조건동영상 입력 또는 원래 이어 만들기 작업이 유효하지 않습니다. | 다음 단계유효한 HTTPS 입력을 사용하세요. 이어 만들기에는 동일한 API 키로 완료된 원본의 공개 동영상 ID를 사용하세요. |
응답402 · billing_error | 조건사용 가능한 잔액 또는 한도로는 예약할 수 없습니다. | 다음 단계새 요청을 전송하기 전에 사용 가능한 잔액과 한도를 확인하세요. |
응답503 · server_error | 조건동영상 검증, 저장소 또는 서비스 접근을 일시적으로 사용할 수 없습니다. | 다음 단계서비스를 사용할 수 있을 때까지 기다리세요. 이미 동영상 ID가 있으면 새로 생성하지 말고 해당 원래 작업을 확인하세요. |
응답503 · result_pending_check | 조건원래 동영상 결과와 청구액을 확인해야 합니다. | 다음 단계반환된 동영상 ID를 보존하고 해당 작업을 확인하세요. 확인 중에는 대체 생성 요청을 전송하지 마세요. |
응답503 · owned_result_unavailable | 조건기존 동영상 다운로드를 일시적으로 사용할 수 없습니다. | 다음 단계나중에 동일한 동영상 작업을 확인하고 기존 출력을 다운로드하세요. 새로 생성하면 별도의 작업이 만들어집니다. |
응답409 · video_not_ready | 조건동영상 콘텐츠가 게시되지 않았습니다. | 다음 단계원래 작업 상태를 확인하세요. completed를 보고하면 다운로드하고, failed를 보고하면 청구 확인 안내를 따르세요. |
별칭
모델 별칭
Ailoot Ultra bytedance/seedance-2.0
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · ByteDance: Seedance 2.0
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/videos·bytedance/seedance-2.0:text,image,audio→video- 요청은 어떤 필드를 사용하나요?
POST /v1/videos·bytedance/seedance-2.0:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- 어떤 제한이 적용되나요?
POST /v1/videos·bytedance/seedance-2.0:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807