Source: https://ailoot.ai/models/ko/bytedance-seedance-2-0-mini/
Canonical: https://ailoot.ai/models/ko/bytedance-seedance-2-0-mini/
Language: ko

# ByteDance: Seedance 2.0 Mini

[Markdown](https://ailoot.ai/models/ko/bytedance-seedance-2-0-mini/index.md) · [JSON](https://ailoot.ai/models/ko/bytedance-seedance-2-0-mini/facts.json)

## [ByteDance: Seedance 2.0 Mini](https://ailoot.ai/models/ko/bytedance-seedance-2-0-mini/)

Seedance 2.0 Mini는 텍스트, 이미지, 영상, 오디오 참조로 짧은 영상을 만들며 필요하면 소리도 생성합니다. 장면 제작, 특정 대상 영상 편집, 이어 만들기를 지원하며 문서상의 출력 규격은 480p 또는 720p입니다.

- [**Ailoot Ultra · 동영상** `POST /v1/videos` `bytedance/seedance-2.0-mini`](https://ailoot.ai/models/ko/bytedance-seedance-2-0-mini/#method-0)

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

Seedance 2.0 Mini는 ByteDance의 Seedance 2.0 시청각 계열에서 별도 이름을 가진 모델입니다. 제조사는 텍스트 영상 변환, 첫 프레임 및 첫·마지막 프레임 이미지 영상 변환, 멀티모달 참조 생성, 영상 편집, 영상 확장을 문서화합니다. 화면과 함께 소리를 생성할 수 있습니다. 작성된 요구사항, 고정 시작 이미지, 두 경계 프레임, 편집이나 이어 만들기가 필요한 클립 등 이미 가진 자료에 따라 제작 모드를 선택하세요.

Mini에는 자체 출력 규격이 있습니다. 제조사는 8비트 색상, 초당 24프레임, MP4 출력의 480p 및 720p 영상을 명시합니다. 지원 화면비는 21:9, 16:9, 4:3, 1:1, 3:4, 9:16이며 문서상의 생성 길이는 4~15초입니다. 제작사의 길이 제어는 이 범위 안의 자동 선택도 허용합니다. 전체 Seedance 2.0 모델의 1080p 및 4K 옵션은 별개이며 Mini 설정이 아닙니다. 계열 기능 표에는 마지막 생성 프레임 반환이 있지만 Draft 모드는 지원되지 않습니다.

Omni reference는 제공된 자료에서 선택한 정보를 사용해 새 장면을 만듭니다. 이미지는 피사체 외형, 구도, 시각적 표현을 정의할 수 있습니다. 영상은 행동, 카메라 움직임, 효과를 정하고 오디오 참조는 음색, 멜로디, 발화 내용을 정할 수 있습니다. 모든 속성을 복사하라고 요청하기보다 각 참조에서 무엇을 가져올지 알려 주세요. 예를 들어 제품 사진은 형태와 색, 짧은 카메라 움직임 클립은 접근 동작, 소리 참조는 분위기에 사용합니다.

계열 워크플로는 참조 이미지 최대 9개, 영상 클립 3개, 오디오 클립 3개를 허용합니다. 영상 참조는 각각 2~15초이며 합계는 15초를 넘을 수 없습니다. 오디오 참조에도 같은 개별 및 총길이 한도가 적용됩니다. 오디오만 입력하거나 시각 참조 없이 텍스트와 오디오만 결합하는 것은 지원되지 않습니다. 텍스트만으로 제작하는 모드는 별도로 지원됩니다. 시퀀스에서는 의도한 순서로 자산을 제공하고 각 미디어 유형 안의 순서에 따라 Image 1, Video 1, Audio 1처럼 일관되게 참조하세요. 작성된 프롬프트의 번호 참조를 자산 식별자로 바꾸지 마세요.

첫 프레임 이미지는 이미지 중심 숏의 시작을 정의합니다. 첫·마지막 프레임 모드는 양쪽 경계를 정의합니다. 정확한 경계 이미지가 중요하면 omni-reference 프롬프트 안에서 참조를 시작과 끝으로 설명하지 말고 해당 전용 모드를 선택하세요. 전자는 프롬프트로 유도하는 효과이며 엄격한 경계 프레임 선택과 동등하지 않습니다. 출력 구도에 맞게 이미지를 준비하고 시작과 종료 상황을 연결하는 행동을 명시하세요.

영상 편집은 기존 클립을 영감으로만 쓰지 않고 변경합니다. 편집할 영상, 바꿀 물체나 영역, 등장 시간과 위치, 보존할 세부 사항을 식별하세요. 예를 들어 “Video 1의 머그를 Image 1에 보이는 용기로 바꾸세요. 손동작, 프레이밍, 조명, 테이블 배치를 유지하세요.”라고 쓸 수 있습니다. 제거할 때는 불필요한 물체와 남겨야 할 주변 요소를 명시하세요. 제조사는 편집이나 확장 시 대상 영상을 직접 지칭하라고 권장합니다. 참조라고 표현하면 새 장면을 생성하라는 요청으로 전달될 수 있습니다.

영상 확장은 기존 클립 앞이나 뒤에 사건을 추가합니다. 이어 만들 방향과 이후 또는 이전에 일어날 일을 설명하세요. 문서화된 워크플로는 생성된 전환으로 두 개나 세 개의 클립을 연결할 수도 있습니다. 세 입력 영상의 합계도 15초 참조 예산 안에 들어가야 합니다. 튜토리얼은 주로 원본 클립의 경계 영상을 포함하는 이어 만들기와 원본 내용을 명시적으로 유지하는 요청을 구분합니다. 이어지는 부분만 필요한지, 제공한 클립과 새 행동을 포함한 장면이 필요한지 결과 구성을 명시하세요.

명확한 지시를 위해 고정된 장면 설명과 사건 순서를 분리하세요. 각 피사체를 구별되는 시각 특징 두세 가지와 일관된 라벨로 정의한 뒤 행동, 배경, 조명, 카메라 움직임, 시각 스타일, 제약을 설명하세요. 대화에서는 각 대사를 화자 및 관련 행동과 연결하세요. 제조사는 정확한 타이밍이 불안정할 수 있다고 설명하므로 정확한 타임스탬프를 믿을 만한 제어로 취급하지 말고 순서가 있는 숏 라벨을 사용하세요. 단계별 제품 요구사항은 “Image 1은 Product A를 정의합니다. Shot 1: 카운터 위 Product A에 천천히 접근합니다. Shot 2: 손이 빛을 향해 돌립니다. Shot 3: 정면 라벨에 멈춥니다. 부드러운 실내 환경음. 인쇄된 글자를 보존하세요.”라고 쓸 수 있습니다.

문서화된 계열 입력 규칙에 맞게 참조를 준비하세요. 지원 이미지 형식에는 JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF가 포함되며 각 이미지는 30 MB 미만입니다. 안내는 이미지 너비와 높이가 300픽셀보다 크고 6,000픽셀보다 작으며 화면비는 0.4보다 크고 2.5보다 작아야 한다고 명시합니다. 영상 참조는 H.264 또는 H.265 영상과 AAC 또는 MP3 오디오를 포함한 MP4 또는 MOV이며 각각 최대 200 MB, 초당 24~60프레임입니다. 너비와 높이는 300~6,000픽셀, 화면비는 0.4~2.5, 총픽셀 수는 407,696~8,295,044입니다. 오디오 참조는 WAV 또는 MP3이며 각각 최대 15 MB입니다. 이는 제조사의 입력 준비 규격이며 특정 애플리케이션의 업로드 제어와 구분됩니다.

제조사의 인물 워크플로는 실제 사람 얼굴이 포함된 이미지나 영상에 특정 준비를 요구하며 직접 참조 업로드가 표준 지원 경로는 아닙니다. 신뢰된 모델 출력, 사전 설정 디지털 캐릭터, 허가된 실제 인물 자산 워크플로를 별도 해결책으로 설명합니다. 목소리 일치, 발음, 클립 경계의 소리도 점검해야 합니다. 프롬프트 안내는 의도한 목소리 특징을 설명하고 대화 스타일을 오디오 참조와 가깝게 유지하도록 권장합니다. 최종 결과에서 피사체 일관성, 정확한 발화 단어, 행동 타이밍, 프레임 전환, 종료 오디오를 검토한 뒤 요구사항과 다른 특정 요소를 다듬으세요.

**Ailoot Ultra · 동영상** `POST /v1/videos` `bytedance/seedance-2.0-mini`

[`bytedance/seedance-2.0-mini`](https://ailoot.ai/models/ko/#m=bytedance%2Fseedance-2.0-mini&route=Ultra&caller=bytedance%2Fseedance-2.0-mini&fmt=videos)

ByteDance /`bytedance/seedance-2.0-mini`

### 시작하기

Seedance 2.0 Mini는 텍스트, 이미지, 영상, 오디오 참조로 짧은 영상을 만들며 필요하면 소리도 생성합니다. 장면 제작, 특정 대상 영상 편집, 이어 만들기를 지원하며 문서상의 출력 규격은 480p 또는 720p입니다.

허용 입력

텍스트 · 이미지 · 오디오

결과

동영상

### Ailoot에서 사용 가능 · 입력 및 메서드

**Ailoot Ultra · 동영상** `POST /v1/videos`

입력

`text`, `image`, `audio`

출력

`video`

출력 형식

원본 MP4 바이트(정규화·트랜스코딩 없음)

| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
| --- | --- | --- | --- | --- |
| 필드`model` | 유형`string` | 요건필수 | 값과 한도 bytedance/seedance-2.0-mini | 기본값— |
| 필드`prompt` | 유형`string` | 요건필수 | 값과 한도 | 기본값— |
| 필드`duration` | 유형`integer` | 요건필수 | 값과 한도 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 최솟값: 1 최댓값: 600 | 기본값— |
| 필드`resolution` | 유형`string` | 요건선택 사항 | 값과 한도 480p, 720p | 기본값— |
| 필드`aspect_ratio` | 유형`string` | 요건선택 사항 | 값과 한도 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | 기본값— |
| 필드`generate_audio` | 유형`boolean` | 요건선택 사항 | 값과 한도 false, true 조건: generate\_audio를 생략하면 오디오 포함 요금이 선택되고, false로 설정하면 오디오 제외 요금이 선택됩니다. 오디오 트랙이 반환되었는지는 결과의 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 패턴: ^\[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-mini

`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-mini

`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-mini

`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.007** 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 요금표— | 예측 수량— | 과금 단위1K 동영상 토큰당 | 과금 조건입력: with\_video\_input | 요금 reference · 동영상 토큰 가격 · 비교 전용 추정치 **$0.0042** 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 요금표— | 예측 수량— | 과금 단위1K 동영상 토큰당 | 과금 조건오디오: without\_audio | 요금 출력 · 동영상 토큰 가격 · 비교 전용 추정치 **$0.007** 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정예상 생성 비용 | 요금표— | 예측 수량1회 생성 예상치 | 과금 단위— | 과금 조건— | 요금 출력 · 예상 생성 비용 · 비교 전용 추정치 **$0.1512** 생성 전 추정치 이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다. |

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. [금액 확보와 정산 방식 →](https://ailoot.ai/docs/ko/billing/reserve/)

#### 참조 요금 상세 정보

모델 수준의 참조 요금표는 메서드 선택, 견적 또는 요금을 변경하지 않습니다. 실제 과금에는 선택한 Ailoot 메서드 요금이 적용됩니다.

동영상 설정별 요금 참조

#### 설정별 가격

각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.

| 설정 | 과금 조건 | 요금 |
| --- | --- | --- |
| 설정동영상 토큰 요금 | 과금 조건이 가격 키에는 추가 조건이 명시되어 있지 않습니다. | 요금 출력 · 동영상 토큰 가격 **$0.007** 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 과금 조건오디오: without\_audio | 요금 출력 · 동영상 토큰 가격 **$0.007** 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |
| 설정동영상 토큰 요금 | 과금 조건입력: with\_video\_input | 요금 reference · 동영상 토큰 가격 **$0.0042** 1K 동영상 토큰당 비디오 토큰 요율이 기본 가격 참고값입니다. 초당 대표 예상 요금은 별도 참고값이며 추가 요금이 아닙니다. |

### 요청 예제

#### Ailoot Ultra · 동영상

curl · 동영상 생성

```bash
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-mini","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`

##### 작업 상태 확인

GET · 원래 작업의 상태 조회

```bash
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
```

기타 콘텐츠 조회

완료된 내 소유 출력 모두 저장

```bash
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-mini`](https://ailoot.ai/models/ko/#m=bytedance%2Fseedance-2.0-mini&route=Ultra&caller=bytedance%2Fseedance-2.0-mini&fmt=videos)

#### 메서드 경로 별칭

위에 표시된 메서드 경로를 사용하세요.

#### 관련 호출용 ID

[`bytedance/seedance-2.0-mini`](https://ailoot.ai/models/ko/#m=bytedance%2Fseedance-2.0-mini&route=Ultra&caller=bytedance%2Fseedance-2.0-mini&fmt=videos)

FAQ · ByteDance: Seedance 2.0 Mini

어떤 입력과 결과를 사용할 수 있나요?

`POST /v1/videos` · `bytedance/seedance-2.0-mini`: `text`, `image`, `audio` → `video`

요청은 어떤 필드를 사용하나요?

`POST /v1/videos` · `bytedance/seedance-2.0-mini`: `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-mini`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `2`; `frame_images.min_items`: `1`; `seed.minimum`: `-9223372036854775808`; `seed.maximum`: `9223372036854775807`

Claude Code, OpenCode, Hermes, 자체 앱에 Ailoot를 연결하세요.

## 회사와 그 프로젝트 포트폴리오

회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.

## 할인받아 토큰을 구매하세요.

정기 작업에는 구독 할인, 토큰 구매에는 최대 50% 프로모션 코드.

구독

정기 요청에 맞는 할인 요금제를 선택하세요.

최대 50% 프로모션 코드

구매할 때 코드를 넣으면 진행 중 행사에 따라 가격을 다시 계산합니다.

이력의 지출

요청마다 모델, 토큰, 금액을 저장합니다.

[구독 선택](https://ailoot.ai/docs/ko/billing/subscriptions/) · [모델 가격 보기](https://ailoot.ai/models/ko/)

## 판매하는 제품에 API를 연결하세요.

Ailoot 공식 이용 조건과 라이선스 계약으로 SaaS, 앱, 봇에 사용하세요. 재판매에는 리셀러 라이선스를 요청하세요.

상업용 앱

서비스의 유료 기능에 텍스트, 이미지, 영상, 소리 생성을 넣으세요.

리셀러 라이선스

프로젝트 설명과 접근 구조를 보내 사용·재판매의 서면 조건을 요청하세요.

사이트의 문서

연결 전에 공식 이용 조건, 라이선스 계약, 데이터 처리 정책을 읽을 수 있습니다.

[리셀러 라이선스 요청](mailto:support@ailoot.ai) · [공식 이용 조건과 라이선스 계약](https://ailoot.ai/legal/offer?lang=ko)

## Ailoot · 회사와 그 프로젝트 포트폴리오





Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다.





회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.





Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.