Video
Seedance 2.5 Flash
텍스트, 첫/마지막 프레임 또는 멀티모달 참조로 480p 또는 720p의 4–30초 동영상을 생성하거나 원본 동영상 하나를 편집합니다.
Seedance 2.5 Flash는 텍스트 기반 동영상 생성, 첫/마지막 프레임 기반 생성, 참조 기반 생성 및 동영상 편집을 지원합니다. Default 등급에서 dreamina-seedance-2-5-flash를 사용합니다. 미디어는 인증 정보가 없는 공개 HTTP 또는 HTTPS URL로 전송합니다. 반환된 작업 ID를 저장하고 해당 ID로 조회하여 완성된 동영상을 확인합니다.
플레이그라운드 및 실시간 가격, OpenAPI 명세 및 요금 가이드를 확인합니다.
간단한 예제
이 요청은 4초 동영상을 생성합니다. 전송 전에 현재 가격을 확인합니다. 제출한 생성 요청이 성공하면 요금이 부과됩니다.
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "dreamina-seedance-2-5-flash",
"content": [{"type": "text", "text": "A ceramic cup slowly rotates under warm studio lighting."}],
"resolution": "480p",
"duration": 4,
"ratio": "16:9",
"generate_audio": false
}'매개변수
model과 content는 필수입니다. 나머지 모든 필드는 선택 사항입니다. 명시적인 null 값과 알 수 없는 필드는 거부됩니다.
| 필드 | 유형 | 기본값 | 제약 조건 |
|---|---|---|---|
model | 문자열 | 필수 | dreamina-seedance-2-5-flash |
content | 배열 | 필수 | 비어 있지 않은 텍스트 항목이 하나 이상 필요합니다. 미디어 항목에는 역할이 필요합니다. |
resolution | 문자열 | 720p | 480p 또는 720p. |
duration | 정수 | 5, 편집 시 -1 | 생성: 4–30초. 편집: 생략하거나 -1을 사용합니다. 출력은 원본을 따릅니다. |
ratio | 문자열 | 16:9, 프레임/편집 시 adaptive | 텍스트/참조 기반 생성: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9. 첫/마지막 프레임 및 편집: adaptive만 허용됩니다. |
generate_audio | 불리언 | true | 생성 오디오를 활성화하거나 비활성화합니다. 요율은 변경되지 않습니다. |
omni_reference_task_type | 문자열 | generate | generate 또는 edit. 편집에는 정확히 하나의 동영상이 필요합니다. |
content_filter | 불리언 | true | true만 허용됩니다. 플레이그라운드에는 조작 항목이 필요하지 않습니다. |
문서에 명시된 프롬프트 최대 길이는 10,000토큰입니다. 공개 토크나이저가 지정되어 있지 않으므로 문자 수를 정확한 토큰 수로 간주해서는 안 됩니다.
콘텐츠 및 모드
텍스트에는 {"type":"text","text":"Describe the shot"}를 사용합니다. 이미지, 동영상 및 오디오에는 중첩된 URL과 명시적인 역할을 사용합니다.
{
"type": "image_url",
"image_url": {"url": "https://example.com/reference.jpg"},
"role": "reference_image"
}| 모드 | 콘텐츠 | 화면 비율 및 길이 |
|---|---|---|
| 텍스트 기반 동영상 생성 | 텍스트만 사용 | 고정 비율, 4–30초. |
| 첫/마지막 프레임 | 텍스트와 first_frame 이미지 하나, 선택적으로 last_frame 이미지 하나 | adaptive, 4–30초. 마지막 프레임에는 첫 프레임이 필요합니다. |
| 참조 기반 생성 | 텍스트와 reference_image, reference_video 또는 reference_audio 항목 | 고정 비율, 4–30초. 이미지 최대 10개, 동영상 최대 5개 및 오디오 최대 5개. |
| 동영상 편집 | 텍스트, 정확히 하나의 reference_video, 선택적인 참조 이미지/오디오, 작업 유형 edit | adaptive, 길이는 생략하거나 -1. |
동영상 항목에는 type: "video_url", video_url: {"url": "..."}, role: "reference_video"를 사용합니다. 오디오 항목에는 같은 구조로 audio_url과 reference_audio를 사용합니다. 첫/마지막 프레임은 참조 미디어와 함께 사용할 수 없습니다. 이 연동에서는 Draft, Extend, 1080p, 워터마크, 시드 및 마지막 프레임 출력 조작 항목을 사용할 수 없습니다. 콜백은 제공되지 않습니다.
미디어 제약 조건
| 미디어 | 형식 | 크기 및 길이 |
|---|---|---|
| 이미지 | JPEG, PNG, WebP | 최대 30 MB, 각 변 300–6,000 px, 너비/높이 비율 0.4–2.5. |
| 동영상 | MP4, MOV | 최대 200 MB, 24–60 FPS, 각 변 300–6,000 px, 비율 0.4–2.5, 409,600–8,295,044픽셀. 참조: 각각 2–30초, 합계 최대 30초. 편집 원본: 4–30초. |
| 오디오 | WAV, MP3 | 최대 15 MB, 각각 2–30초, 합계 최대 30초. |
제출 전에 파일을 읽을 수 있어야 합니다. 요금을 계산하기 위해 미디어에서 동영상 길이를 측정합니다. 안정적인 공개 URL을 사용합니다.
작업 응답 및 폴링
생성 시 id, model, status 및 created_at이 반환됩니다. 완료될 때까지 같은 작업을 조회합니다.
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"상태는 processing, completed 또는 failed입니다. 성공 시 output.video_url에서 저장된 동영상을 확인합니다. 실패 시 error.code와 error.message를 확인합니다. 공개 응답에는 비용이 포함되지 않습니다. 폴링 시간 초과가 생성 실패를 증명하는 것은 아닙니다. 다른 생성 요청을 제출하는 대신 작업 ID를 보관하고 다시 조회합니다.
요금 청구
실시간 요율은 해상도와 동영상 제공 여부에 따라 달라집니다. 동영상 입력이 없으면 청구 초는 출력 길이와 같습니다. 참조 동영상이 있으면 청구 초는 출력 길이에, 출력 길이와 올림한 총 입력 길이 중 더 큰 값을 더한 값입니다. 편집 시에는 올림한 원본 길이의 두 배가 청구됩니다. 오디오가 포함됩니다. 실패한 요청에는 요금이 부과되지 않습니다.
예를 들어 참조 동영상이 3초이고 출력이 5초이면 10초가 청구됩니다. 10초 원본을 편집하면 20초가 청구됩니다. 청구 초에 해당 실시간 요율을 곱합니다.