API 문서 · 모델 및 과금
모델 기능표
모드, 해상도, 길이, 화면 비율 및 입력 제한.
아래 표는 GET /portal/public/models에서 실시간으로 렌더링되며, API 파라미터 검증과 동일한 기능표를 사용합니다. Key로 GET /v1/models를 호출하면 해당 Key에서 사용할 수 있는 모델을 확인할 수 있습니다.
Seedance 2.0 Fast
seedance-2.0-fast- 생성 모드
- 텍스트→영상첫 프레임 기반첫·끝 프레임 기반멀티모달 참고
- 해상도
- 480p / 720p
- 길이
- 4–15초 또는 모델 자동 결정
- 화면 비율
- 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / 자동 맞춤
- 프레임 레이트
- 24 fps
- 입력 소재
- 이미지 최대 9장, 장당 ≤ 30.0 MB영상 최대 3개, 합계 ≤ 15초오디오 최대 3개, 이미지나 영상과 함께 제공
- 프롬프트
- 최대 2000자
Seedance 2.0 Mini
seedance-2.0-mini- 생성 모드
- 텍스트→영상첫 프레임 기반첫·끝 프레임 기반멀티모달 참고
- 해상도
- 480p / 720p
- 길이
- 4–15초 또는 모델 자동 결정
- 화면 비율
- 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / 자동 맞춤
- 프레임 레이트
- 24 fps
- 입력 소재
- 이미지 최대 9장, 장당 ≤ 30.0 MB영상 최대 3개, 합계 ≤ 15초오디오 최대 3개, 이미지나 영상과 함께 제공
- 프롬프트
- 최대 2000자
Seedance 2.0
seedance-2.0-standard- 생성 모드
- 텍스트→영상첫 프레임 기반첫·끝 프레임 기반멀티모달 참고
- 해상도
- 480p / 720p / 1080p
- 길이
- 4–15초 또는 모델 자동 결정
- 화면 비율
- 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / 자동 맞춤
- 프레임 레이트
- 24 fps
- 입력 소재
- 이미지 최대 9장, 장당 ≤ 30.0 MB영상 최대 3개, 합계 ≤ 15초오디오 최대 3개, 이미지나 영상과 함께 제공
- 프롬프트
- 최대 2000자
Seedance 2.5
seedance-2.5- 생성 모드
- 텍스트→영상첫 프레임 기반첫·끝 프레임 기반멀티모달 참고
- 해상도
- 480p / 720p / 1080p
- 길이
- 4–30초 또는 모델 자동 결정
- 화면 비율
- 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / 자동 맞춤
- 프레임 레이트
- 24 fps
- 입력 소재
- 이미지 최대 30장, 장당 ≤ 30.0 MB영상 최대 10개, 합계 ≤ 30초오디오 최대 10개
- 프롬프트
- 최대 4000자
입력 역할
| role | 에셋 유형 | 설명 |
|---|---|---|
first_frame | 이미지 | 첫 프레임 기반 생성. last_frame과 함께 쓰면 첫·마지막 프레임 생성. 참고 계열 역할과 함께 사용할 수 없음 |
last_frame | 이미지 | 마지막 프레임. first_frame을 함께 제공해야 함 |
reference_image | 이미지 | 멀티모달 참고 |
reference_video | 영상 | 멀티모달 참고. "영상 입력 포함" 요금으로 과금 |
reference_audio | 오디오 | 멀티모달 참고. 기능표에서 요구하는 경우 reference_image 또는 reference_video를 함께 제공해야 함(첫 프레임, 마지막 프레임은 해당하지 않음) |
지원하지 않는 파라미터 조합이면 422 invalid_parameter를 반환하고 param에 해당 필드를 표시합니다. 플랫폼은 파라미터를 바꾸지 않습니다. 요청 본문에 정의되지 않은 최상위 필드는 무시되며, 모델 전용 파라미터는 provider_options에 넣어야 합니다. 알 수 없는 키는 422를 반환합니다.
참고 이미지 + 참고 오디오
POST https://cn-api.aitoken.tools/v1/videos/generations
{
"model": "seedance-2.0-standard",
"prompt": "인물이 카메라를 보며 미소 짓는다, 배경은 흐리게",
"inputs": [
{ "type": "image", "asset_id": "asset_xxx", "role": "reference_image" },
{ "type": "audio", "asset_id": "asset_yyy", "role": "reference_audio" }
],
"duration": 8,
"resolution": "1080p",
"ratio": "9:16",
"max_budget": "30.000000",
"callback_url": "https://example.com/hooks/video",
"metadata": { "order_id": "A-1001" }
}