ByteDance: Seedance 2.0 Fast

Seedance 2.0 Fast는 영상 생성·편집·확장을 위한 멀티모달 Fast 프로필입니다. 텍스트, 이미지, 영상, 오디오 참조 자료를 받으며, 동기화된 사운드 또는 무음 출력을 지원합니다. 문서상 클립은 길이 4–15초, 해상도 480p 또는 720p입니다.

Ailoot Ultra · 동영상 POST /v1/videos doubao-seedance-2-0-fast-260128

모델 소개

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

Seedance 2.0 Fast는 doubao-seedance-2-0-fast-260128로 선택하는, 별도로 이름 붙은 Fast 프로필입니다. 텍스트, 이미지, 영상, 오디오 참조 자료를 이용한 영상 생성, 편집, 확장을 지원합니다. 장면 지시에 외형 설명만으로 부족할 때 유용하며, 기존 미디어로 연기, 카메라 표현, 소리도 전달할 수 있습니다. Fast라는 이름은 요청에서 지정하는 모델을 구분하며, 개별 비동기 작업이 고정된 시간 안에 끝난다는 약속은 아닙니다.

새 숏을 결정할 요소부터 시작하세요. 텍스트만으로 새 장면을 설명할 수 있습니다. 이미지는 인물, 상품, 구도를 정하고, 영상은 움직임이나 수정·확장할 기존 시퀀스를 제공할 수 있습니다. 문서화된 콘텐츠 조합에는 이미지와 오디오, 영상과 오디오, 이미지·영상·오디오의 동시 사용이 있으며, 시각 미디어와 함께 쓰는 텍스트는 선택 사항입니다. 이 조합은 오디오만 쓰는 독립 요청을 설명하지 않으므로, 사운드 참조는 그것이 안내할 시각적 원본과 함께 사용하세요.

content 배열과 지시에서 참조 역할을 명확히 하세요. image_url, video_url, audio_url 항목은 reference_image, reference_video, reference_audio 역할을 가질 수 있습니다. 어떤 이미지가 피사체를, 어떤 영상이 카메라나 동작을, 어떤 오디오가 사운드트랙을 제공하는지 설명합니다. 상품 숏에서는 이미지가 포장을 정하고 영상이 물체 옆을 지나는 움직임을 보여 줄 수 있습니다. 짧은 시퀀스가 동작 중간에 끊기지 않고 쓸 만한 마지막 화면을 갖도록 원하는 결말을 지정하세요.

편집에서는 원본 영상, 변경 사항, 유지할 연속성을 지정하세요. 배경이나 조명을 바꿀 때도 의도한 피사체와 동작은 명확히 지정되어야 합니다. 확장에서는 다음에 무슨 일이 일어나고 새 움직임이 기존 장면과 어떻게 연결되는지 설명하세요. 참조는 생성을 안내하는 자료입니다. 이어지는 영상이 모든 프레임의 디테일을 보존한다고 가정하지 말고, 실제 연결 지점과 전체 클립의 외형, 움직임 방향, 타이밍을 확인하세요.

문서상 2.0 Fast 범위는 네 초부터 열다섯 초까지의 정수 초이며, 그 범위 안에서 모델이 길이를 선택하는 -1도 쓸 수 있습니다. 기본 길이는 다섯 초입니다. 출력 해상도는 480p 또는 720p, 기본값은 720p이며 1080p는 제외됩니다. 고정 화면비 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 또는 adaptive(적응형) 구도 중에서 선택하세요. adaptive 구도는 관련 프롬프트나 참조의 맥락을 따릅니다. 첫 프레임을 쓰는 숏은 시작 이미지를 따르고, 멀티모달 구도에서는 영상이 이미지보다 우선할 수 있습니다. 실제 길이와 화면비는 반환된 작업 필드에서 읽으세요.

generate_audio로 생성 영상에 동기화된 사운드를 포함할지 선택하세요. 문서상 기본값은 true이며, false는 무음을 요청합니다. 오디오를 켜면 프로필은 프롬프트와 시각적 콘텐츠에서 목소리, 효과음, 배경 음악을 생성하며, 가이드는 대사를 큰따옴표로 감싸도록 권장합니다. 화자와 사운드·동작 사이의 의도한 관계를 명시하세요. 언어에 능숙한 청취자와 발화를 검토하고, 편집하거나 확장한 구간을 포함해 클립 전체의 사운드 일치를 확인하세요.

2.0 Fast 가이드는 기존 frames 및 camera_fixed 제어를 제외하고 flex 오프라인 처리를 지원하지 않습니다. 카메라 동작은 장면 안에서 설명하고, 클립 길이에는 duration을 쓰세요. seed와 워터마크 옵션은 계속 문서화되어 있습니다. 같은 seed가 동일한 출력을 보장하지 않으므로, 수정본을 비교할 때 요청 설정에만 의존하지 말고 완성 결과물을 보관하세요.

영상 토큰 사용량은 (입력 영상 길이 + 출력 영상 길이) × 출력 너비 × 출력 높이 × 출력 프레임 속도 / 1024로 계산합니다. 입력 영상이 있는 요청과 없는 요청은 별개의 과금 범주입니다. 작업 조회는 usage.completion_tokens와 usage.total_tokens를 보고합니다. 이 보고 수량을 완성 클립과 함께 보관하세요.

완성 영상이 준비되기 전에 제출 시 작업 ID가 반환됩니다. 처리 상태를 추적하고, 성공 후 content.video_url을 가져온 다음, 보고된 길이, 해상도, 화면비, 프레임 속도, 사용량을 결과와 함께 보관하세요. 만료 기간은 작업 생성 시점부터 측정하며, 기본값은 172800초, 범위는 3600~259200초입니다. 최종 클립을 참조 및 프롬프트와 함께 저장하고, 전체 시퀀스에서 피사체 정체성, 물체 접촉, 카메라 연속성, 사운드 타이밍을 확인하세요.

Ailoot Ultra · 동영상 POST /v1/videos doubao-seedance-2-0-fast-260128

doubao-seedance-2-0-fast-260128

ByteDance /doubao-seedance-2-0-fast-260128

시작하기

허용 입력: 텍스트 · 이미지 · 동영상 · 오디오
결과: 동영상

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

Ailoot Ultra · 동영상 POST /v1/videos

입력: text, image, video, audio
출력: video

필드	유형	요건	값과 한도	기본값
필드`model`	유형`string`	요건필수	값과 한도 doubao-seedance-2-0-fast-260128	기본값—
필드`content`	유형`array`	요건필수	값과 한도 조건: 네이티브 텍스트/미디어 객체입니다. 바깥쪽 배열은 비어 있으면 안 됩니다. 이 Ailoot 범용 생성자는 중첩 노드의 유형을 검증하지 않습니다.	기본값—
필드`generate_audio`	유형`boolean`	요건선택 사항	값과 한도 조건: 동영상에 삽입된 동기화된 사운드입니다.	기본값true
필드`duration`	유형`integer`	요건선택 사항	값과 한도 조건: 정수 4–15 또는 -1입니다. 실제 출력 길이가 반환됩니다.	기본값5
필드`resolution`	유형`string`	요건선택 사항	값과 한도 480p, 720p 조건: 2.0/fast에서는 1080p를 지원하지 않는다고 명시되어 있습니다.	기본값720p
필드`ratio`	유형`string`	요건선택 사항	값과 한도 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive 조건: Adaptive의 명시된 적용 범위는 2.0/fast/1.5입니다. 2.5 예제에는 16:9만 있습니다.	기본값adaptive
필드`watermark`	유형`boolean`	요건선택 사항	값과 한도	기본값false
필드`seed`	유형`integer`	요건선택 사항	값과 한도 최솟값: -1 최댓값: 4,294,967,295	기본값-1
필드`execution_expires_after`	유형`integer`	요건선택 사항	값과 한도 최솟값: 3,600 최댓값: 259,200 단위: 초	기본값172,800
필드`service_tier`	유형`string`	요건선택 사항	값과 한도 default 조건: 2.0/fast는 오프라인 flex를 제외합니다. 2.5의 적용 범위는 확정되지 않았습니다.	기본값default
필드`safety_identifier`	유형`string`	요건선택 사항	값과 한도	기본값—
필드`tools`	유형`object`	요건선택 사항	값과 한도 조건: 2.0/fast만 해당합니다. 문서에 명시된 값은 type=web_search입니다.	기본값—

입력 자료 조합

메서드 매개변수와 수명 주기

매개변수	명세
매개변수`content_type`	명세application/json
매개변수`required`	명세content, model
매개변수`optional`	명세generate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier, tools
매개변수`material_types`	명세text, image, video, audio
매개변수`additional_properties`	명세true
매개변수`validation_scope`	명세Ailoot는 필수 필드의 유형과 비어 있지 않은 model/content 배열을 확인합니다. 다른 요청 필드는 선택한 모델에 전달되도록 보존됩니다.
매개변수`material_combinations`	명세text, image, video, image, audio, image, video, video, audio, image, video, audio
매개변수`optional_text_with_media`	명세true
매개변수`reference_media_count_and_size_limits`	명세null

메서드 별칭: /v1/videos/generations

수명 주기: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

한 번 생성하고 반환된 공개 id/polling_url을 보존하세요.

원래 작업을 폴링하세요. succeeded 이후 실제 소유한 content.video_url을 다운로드하세요.

요금

최종 요금 계산 방식

표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.

요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.

빠른 모드: 미지정 빠른 모드를 선택한 경우
Flex 모드: 미지정 flex 모드를 선택한 경우
최대 추론 수준: 미지정 최대 추론 수준에 default 조정값을 적용하는 경우

비교용 예상 요금

설정별 가격

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

설정	요금표	예측 수량	과금 단위	요금
설정기본 토큰 요금	요금표기본 요금	예측 수량—	과금 단위—	요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰
설정입력에 영상이 포함됩니다.	요금표—	예측 수량—	과금 단위1K 동영상 토큰당	요금 출력 · 비교 전용 추정치 $0.007536 1K 동영상 토큰당
설정입력에 영상이 포함되지 않습니다.	요금표—	예측 수량—	과금 단위1K 동영상 토큰당	요금 출력 · 비교 전용 추정치 $0.013032 1K 동영상 토큰당
설정예상 생성 비용	요금표—	예측 수량1회 생성 예상치	과금 단위—	요금 출력 · 예상 생성 비용 · 비교 전용 추정치 $0.822402 생성 전 추정치 이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다.

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →

요청 예제

Ailoot Ultra · 동영상

curl · 동영상 생성curl · 원본 작업 조회curl · 소유한 동영상 다운로드

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-2-0-fast-260128","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}]}
JSON_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

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i.startswith("native302_"):raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json

set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("status")!="succeeded":raise SystemExit("Poll same original job until an owned result is returned.")
u=r.get("content",{}).get("video_url")
urls=[u] if isinstance(u,str) else u
if not isinstance(urls,list) or not urls:raise SystemExit("No completed video URL.")
for u in urls:
    if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
    p=urlsplit(u)
    if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for actual Ailoot-owned signed result.")
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
  curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
  index=$((index + 1))
done < asset-urls.txt

결과 수신 및 저장

Ailoot Ultra · 동영상

공개 id/polling_url이 있는 네이티브 JSON입니다. 게시 후에는 content.video_url에 Ailoot가 소유한 서명된 URL이 포함됩니다. 게시 전에는 선택된 출력 URL이 비워집니다.

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

완료된 결과 모두 보관

완료된 모든 동영상과 반환된 파일을 저장하고, 실제로 반환된 모든 자산 URL에서 가져오세요.

content.video_url에 있는 모든 실제 URL을 보존하세요. index는 실제 반환된 출력을 식별해야 합니다.

원래 응답을 확인해야 할 경우

원본 응답/헤더/id를 보존하고 해당 작업을 폴링하세요. 결과를 알 수 없는 생성을 절대로 다시 제출하지 마세요.

응답 필드

필드	유형
필드`id`	유형string
필드`provider_task_id`	유형string
필드`polling_url`	유형string
필드`status`	유형string when supplied
필드`content.video_url`	유형string\|string[]
필드`usage`	유형object when supplied

오류와 다음 단계

응답	조건	다음 단계
응답400 · `invalid_request_error`	조건JSON/모델/필수 필드 유형 또는 콘텐츠 인덱스가 유효하지 않습니다.	다음 단계
응답401 · `authentication_error`	조건유효하지 않은 Ailoot API 키입니다.	다음 단계
응답404 · `not_found_error`	조건작업/출력이 없거나 동일한 사용자/API 키/그룹의 소유가 아닙니다.	다음 단계
응답502 · `result_pending_check`	조건최초 제출/상태 정보가 불완전합니다. 원래 ID를 보존하고 다시 제출하지 마세요.	다음 단계
응답503 · `result_pending_check`	조건원래 미디어/경로/정산을 확인 중입니다. 원래 작업을 계속 진행하세요.	다음 단계

별칭

모델 별칭

Ailoot Ultra doubao-seedance-2-0-fast-260128

메서드 경로 별칭

/v1/videos/generations

ByteDance: Seedance 2.0 Fast