모델

ByteDance: Seedance 1.0 Pro

Markdown · JSON

ByteDance: Seedance 1.0 Pro

Seedance 1.0 Pro는 텍스트나 시작 이미지에서 무음 영상을 생성합니다. 동작과 카메라를 설명하거나 기존 구도에 움직임을 더할 수 있으며, 길이 2–12초, 24 fps와 명시적인 출력 구도·해상도 제어를 지원합니다.

모델 소개

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

Seedance 1.0 Pro는 텍스트나 이미지를 바탕으로 한 장면에서 영상을 생성합니다. 선택자 doubao-seedance-1-0-pro-250528은 두 입력 모드를 모두 지원하므로, 글로 쓴 구상이나 기존 시각적 구도에서 시작할 수 있습니다. 새 장면에는 텍스트 지시를 쓰고, 피사체·배치·시작 화면을 시각적으로 정해야 할 때는 이미지를 제공하세요. 이 1.0 프로필의 출력은 무음 영상이며, 동기화된 사운드는 별도로 설명된 1.5 Pro 프로필의 기능입니다.

텍스트로 영상을 생성할 때는 피사체, 환경, 움직임, 구도, 카메라를 하나의 일관된 장면으로 지정하세요. 문서의 예는 데이지 들판에서 꽃잎에 이슬이 맺힌 꽃의 근접 화면으로 서서히 이동합니다. 이런 구조는 다른 대상을 드러낼 때도 유용합니다. 배경을 소개하고 피사체로 다가간 뒤 중요한 디테일에서 마무리하세요. 상품 구상에는 동작과 함께 소재와 조명도 설명하고, 짧은 숏 안에서 실현 가능한 카메라 경로를 지정하세요.

이미지로 영상을 생성할 때는 image_url 형식의 content 항목에 참조 이미지를 넣고, 그 시작 화면에서 무엇이 달라져야 하는지 설명하세요. 준비된 인물 사진으로 사람과 크롭을 정하고, 글로 작은 고개 돌림, 머리카락 움직임, 부드러운 카메라 후퇴를 설명할 수 있습니다. 상품 정지 이미지로 물체와 배경을 정하고, 프롬프트로 통제된 방식의 공개 장면을 요청할 수도 있습니다. 요청한 움직임을 원본 구도에 맞추세요. 물체의 한쪽 이미지가 보이지 않는 모든 다른 면의 정확한 모습까지 제공하지는 않습니다.

이미지 필드는 접근 가능한 URL 또는 Base64 이미지 데이터를 담은 data URL을 받습니다. 문서에 명시된 형식은 JPEG, PNG, WEBP, BMP, TIFF, GIF입니다. 이미지는 30 MB 미만이어야 하며, 너비와 높이의 비율은 0.4보다 크고 2.5보다 작아야 하고, 각 변은 300픽셀보다 크고 6000픽셀보다 작아야 합니다. 핵심 디테일이 이미 사라진 썸네일에 의존하지 말고, 원하는 크롭으로 선명한 원본을 준비하세요. 이미지 기반 영상 생성에는 참조 이미지의 비율을 따르는 adaptive(적응형) 구도가 권장됩니다.

문서상 1.0 길이는 두 초부터 열두 초까지이며, 프레임 속도는 24 fps입니다. 출력 설정에는 480p, 720p, 1080p가 있으며 Pro 기본값은 1080p입니다. 다만 가이드는 참조 이미지를 쓰는 경우 1080p를 제외합니다. 고정 화면비는 16:9, 4:3, 1:1, 3:4, 9:16, 21:9입니다. 이미지 중심 숏에는 모든 텍스트 기반 영상 설정을 그대로 옮기지 말고, 이미지와 호환되는 조합을 선택하세요. 클립을 레이아웃에 배치하기 전에 실제 반환된 구도를 확인하세요.

seed 및 워터마크 제어는 camerafixed와 함께 문서화되어 있습니다. 카메라 고정 지시는 참조 이미지를 쓰는 경우 지원되지 않으며, 적용되는 경우에도 가이드는 완벽히 정지한 카메라를 보장하지 않습니다. 프롬프트 안의 매개변수 지시는 별도의 선택적 필드보다 우선합니다. 길이, 해상도, 화면비를 정하는 설정을 하나로 통일하고 카메라 설명도 이에 맞추세요. 그러면 장면 지시가 요청에서 선택한 설정을 모르게 덮어쓰는 일을 방지할 수 있습니다.

사용량은 영상 토큰으로 측정하며, 출력 너비 × 출력 높이 × 프레임 속도 × 출력 길이 / 1024로 계산합니다. 완료된 작업은 이 수량을 usage.completion_tokens로 보고합니다. 보고된 사용량을 완성 클립 및 요청 설정과 함께 보관하세요.

먼저 작업 ID가 반환되고, 처리 후에 완성 영상의 위치가 제공됩니다. queued 또는 running 상태를 확인하는 동안 ID를 보관하세요. succeeded 상태의 작업은 content.video_url과 사용량 정보를 제공합니다. 문서상 생성 파일 보관 기간은 일주일입니다. 완성 클립, 원본 이미지, 정확한 프롬프트를 수정 기록으로 저장한 다음, 전체 결과의 피사체 외형, 움직임, 이미지 연속성, 마지막 구도를 검토하세요.

Ailoot Ultra · 동영상 POST /v1/videos doubao-seedance-1-0-pro-250528

doubao-seedance-1-0-pro-250528

ByteDance /doubao-seedance-1-0-pro-250528

시작하기

Seedance 1.0 Pro는 텍스트나 시작 이미지에서 무음 영상을 생성합니다. 동작과 카메라를 설명하거나 기존 구도에 움직임을 더할 수 있으며, 길이 2–12초, 24 fps와 명시적인 출력 구도·해상도 제어를 지원합니다.

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

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

Ailoot Ultra · 동영상 POST /v1/videos
입력
text, image
출력
video
필드유형요건값과 한도기본값
필드model유형string요건필수값과 한도
doubao-seedance-1-0-pro-250528
기본값—
필드content유형array요건필수값과 한도
조건: 네이티브 텍스트/미디어 객체입니다. 바깥쪽 배열은 비어 있으면 안 됩니다. 이 Ailoot 범용 생성자는 중첩 노드의 유형을 검증하지 않습니다.
기본값—
필드duration유형integer요건선택 사항값과 한도
최솟값: 2
최댓값: 12
조건: 기본 1.x 스키마는 2–12입니다. 이후 공통 설명에는 1.5가 4–12 또는 -1로 명시되어 있습니다. 예제는 양쪽 모두에 명시된 5를 사용합니다.
기본값5
필드resolution유형string요건선택 사항값과 한도
조건: 확인된 텍스트 동영상 변환 값은 480p와 1080p입니다. 참조 이미지 입력에서는 1080p가 제외됩니다. 공통 720p 열거형이 모델별 설명과 충돌하므로 두 모드 모두 720p 지원 여부가 확인되지 않았습니다.
기본값1080p
필드ratio유형string요건선택 사항값과 한도
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
조건: 기본값은 장면과 모델에 따라 다릅니다. 이미지 입력 문서에서는 adaptive를 권장합니다.
기본값—
필드service_tier유형string요건선택 사항값과 한도
default, flex
조건: default=online, flex=offline입니다. 생성 전에 선택하세요.
기본값default
필드seed유형integer요건필수값과 한도
최솟값: -1
최댓값: 4,294,967,295
기본값-1
필드camerafixed유형boolean요건필수값과 한도
조건: Ailoot에서 필수로 요구합니다. 문서에는 참조 이미지의 카메라 제어가 지원되지 않는다고 되어 있으며 효과는 보장되지 않습니다.
기본값false
필드watermark유형boolean요건필수값과 한도기본값false
필드execution_expires_after유형integer요건필수값과 한도
최솟값: 3,600
최댓값: 259,200
단위: 초
기본값172,800
입력 자료 조합

메서드 매개변수와 수명 주기
매개변수명세
매개변수content_type명세application/json
매개변수required명세camerafixed, content, execution_expires_after, model, seed, watermark
매개변수optional명세duration, resolution, ratio, service_tier
매개변수material_types명세text, image
매개변수additional_properties명세true
매개변수validation_scope명세Ailoot는 필수 필드의 유형과 비어 있지 않은 model/content 배열을 확인합니다. 다른 요청 필드는 선택한 모델에 전달되도록 보존됩니다.
매개변수image_constraints명세{"formats":["jpeg","png","webp","bmp","tiff","gif"],"aspect_ratio_exclusive":[0.4,2.5],"dimensions_px_exclusive":[300,6000],"file_size_mb_exclusive":30,"mb_bytes_definition":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 토큰
설정Ultra요금표—예측 수량—과금 단위1K 동영상 토큰당요금
출력 · 비교 전용 추정치 $0.0044 1K 동영상 토큰당
설정예상 생성 비용요금표—예측 수량1회 생성 예상치과금 단위—요금
출력 · 예상 생성 비용 · 비교 전용 추정치 $0.2112 생성 전 추정치

이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다.

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

요청 예제

Ailoot Ultra · 동영상

curl · 동영상 생성curl · 원본 작업 조회curl · 소유한 동영상 다운로드
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-250528","content":[{"type":"text","text":"女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800}
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-1-0-pro-250528

메서드 경로 별칭

/v1/videos/generations

관련 호출용 ID

doubao-seedance-1-0-pro-250528

FAQ · ByteDance: Seedance 1.0 Pro
어떤 입력과 결과를 사용할 수 있나요?

POST /v1/videos · doubao-seedance-1-0-pro-250528: text, image → video

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

POST /v1/videos · doubao-seedance-1-0-pro-250528: model, content, duration, resolution, ratio, service_tier, seed, camerafixed, watermark, execution_expires_after

어떤 제한이 적용되나요?

POST /v1/videos · doubao-seedance-1-0-pro-250528: duration.minimum: 2; duration.maximum: 12; seed.minimum: -1; seed.maximum: 4294967295; execution_expires_after.minimum: 3600; execution_expires_after.maximum: 259200

자세히 보기

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

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

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

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

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

구독
정기 요청에 맞는 할인 요금제를 선택하세요.
최대 50% 프로모션 코드
구매할 때 코드를 넣으면 진행 중 행사에 따라 가격을 다시 계산합니다.
이력의 지출
요청마다 모델, 토큰, 금액을 저장합니다.

구독 선택 · 모델 가격 보기

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

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

상업용 앱
서비스의 유료 기능에 텍스트, 이미지, 영상, 소리 생성을 넣으세요.
리셀러 라이선스
프로젝트 설명과 접근 구조를 보내 사용·재판매의 서면 조건을 요청하세요.
사이트의 문서
연결 전에 공식 이용 조건, 라이선스 계약, 데이터 처리 정책을 읽을 수 있습니다.

리셀러 라이선스 요청 · 공식 이용 조건과 라이선스 계약