switch_heading

Seedance 1.5 API 문서

Seedance 1.5 비디오 생성 API를 애플리케이션에 통합하기 위한 완전 가이드.

API v1 · 1.5 Base URL: https://seedanceapi.org/v1

빠른 시작

bash

1	curl -X POST 'https://seedanceapi.org/v1/generate' \
2	-H 'Authorization: Bearer YOUR_API_KEY' \
3	-H 'Content-Type: application/json' \
4	-d '{
5	"prompt": "A cinematic shot of mountains at sunrise with flowing clouds",
6	"aspect_ratio": "16:9",
7	"resolution": "720p",
8	"duration": "8"
9	}'

인증

모든 API 요청은 Authorization 헤더에서 Bearer 토큰을 사용한 인증이 필요합니다.

중요: 대시보드의 API Keys 페이지에서 API 키를 가져올 수 있습니다. → API 키 가져오기

http

1	Authorization: Bearer YOUR_API_KEY

요금

480p

480p 해상도

빠른 생성, 미리보기 및 초안에 적합

길이	오디오 없음	오디오 포함
4s	8 credits	14 credits
8s	14 credits	28 credits
12s	19 credits	38 credits

720p

720p 해상도

고품질 출력, 프로덕션에 권장

길이	오디오 없음	오디오 포함
4s	14 credits	28 credits
8s	28 credits	56 credits
12s	42 credits	84 credits

API 엔드포인트

POST/v1/generate새 비디오 생성

Seedance 1.5 모델로 새 비디오 생성 작업을 생성합니다. 텍스트-비디오 및 이미지-비디오 모드를 지원합니다.

요청 본문

Body ParametersJSON

prompt:string

생성할 비디오의 텍스트 설명 (최대 2000자)

aspect_ratio:optional string

출력 종횡비. 지원: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 Defaults to 1:1.

resolution:optional string

비디오 해상도: 480p 또는 720p Defaults to 720p.

duration:optional string

비디오 길이(초): 4, 8 또는 12 Defaults to 8.

generate_audio:optional boolean

비디오에 대한 AI 오디오 생성 활성화 Defaults to false.

fixed_lens:optional boolean

카메라를 고정하여 모션 블러 감소 Defaults to false.

image_urls:optional string[]

이미지-비디오 생성을 위한 참조 이미지 URL 배열 (최대 1개)

callback_url:optional string

비동기 상태 알림을 위한 Webhook URL. 공개적으로 접근 가능해야 합니다.

텍스트에서 비디오

json

1	{
2	"prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
3	"aspect_ratio": "16:9",
4	"resolution": "720p",
5	"duration": "8"
6	}

이미지에서 비디오

json

1	{
2	"prompt": "The character slowly turns and smiles at the camera",
3	"image_urls": [
4	"https://example.com/my-image.jpg"
5	],
6	"aspect_ratio": "16:9",
7	"resolution": "720p",
8	"duration": "4"
9	}

오디오 생성 포함

json

1	{
2	"prompt": "A peaceful river flowing through a forest with birds singing",
3	"aspect_ratio": "16:9",
4	"resolution": "720p",
5	"duration": "8",
6	"generate_audio": true,
7	"fixed_lens": true
8	}

응답

Task created successfully

1	{
2	"code": 200,
3	"message": "success",
4	"data": {
5	"task_id": "seed15abc123def456pro",
6	"status": "IN_PROGRESS"
7	}
8	}

GET/v1/status작업 상태 가져오기

비디오 생성 작업의 상태를 확인하고 완료 시 결과를 가져옵니다.

쿼리 매개변수

Body ParametersJSON

task_id:string

생성 엔드포인트에서 반환된 고유 작업 ID

요청 예시

bash

1	curl -X GET 'https://seedanceapi.org/v1/status?task_id=seed15abc123def456pro' \
2	-H 'Authorization: Bearer YOUR_API_KEY'

💡 Tip: 상태 API의 response 필드는 비디오 URL 배열입니다. data.response[0]에 직접 접근하여 비디오 URL을 가져올 수 있습니다.

javascript

1	// Extract video URL from response
2	const videoUrl = data.response[0];

응답

1	{
2	"code": 200,
3	"message": "success",
4	"data": {
5	"task_id": "seed15abc123def456pro",
6	"status": "SUCCESS",
7	"consumed_credits": 28,
8	"created_at": "2026-02-07T10:30:00Z",
9	"request": {
10	"prompt": "A majestic eagle soaring through golden sunset clouds",
11	"aspect_ratio": "16:9",
12	"resolution": "720p",
13	"duration": "8"
14	},
15	"response": [
16	"https://cdn.example.com/videos/seed15abc123def456pro.mp4"
17	],
18	"error_message": null
19	}
20	}

API 플레이그라운드

브라우저에서 직접 API를 테스트합니다. YOUR_API_KEY를 실제 API 키로 교체하세요.

API 테스트 환경POST

기본 URL

엔드포인트

헤더

요청 본문

오류 코드

Status	Code	Description
400 잘못된 요청	`INVALID_PROMPT`	프롬프트가 유효하지 않거나 비어있습니다
400 잘못된 요청	`INVALID_ASPECT_RATIO`	지원되지 않는 종횡비입니다
400 잘못된 요청	`INVALID_RESOLUTION`	해상도는 480p 또는 720p이어야 합니다
400 잘못된 요청	`INVALID_DURATION`	길이는 4, 8 또는 12초이어야 합니다
400 잘못된 요청	`TOO_MANY_IMAGES`	image_urls 배열에 최대 1개의 이미지 URL이 허용됩니다
401 인증되지 않음	`INVALID_API_KEY`	API 키가 없거나 유효하지 않습니다
402	`INSUFFICIENT_CREDITS`	이 작업에 크레딧이 부족합니다
404 찾을 수 없음	`TASK_NOT_FOUND`	작업 ID를 찾을 수 없거나 귀하의 계정에 속하지 않습니다
500 내부 서버 오류	`INTERNAL_ERROR`	서버 오류입니다. 나중에 다시 시도해주세요

switch_heading