Seedance 2.0 API 문서

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

API v1.0 Base URL: https://seedanceapi.org/v1

빠른 시작

bash

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

인증

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

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

http

Authorization: Bearer YOUR_API_KEY

요금

480p

480p 해상도

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

길이	오디오 없음	오디오 포함
4s	8 credits ($0.04)	14 credits ($0.07)
8s	14 credits ($0.07)	28 credits ($0.14)
12s	19 credits ($0.095)	38 credits ($0.19)

720p

720p 해상도

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

길이	오디오 없음	오디오 포함
4s	14 credits ($0.07)	28 credits ($0.14)
8s	28 credits ($0.14)	56 credits ($0.28)
12s	42 credits ($0.21)	84 credits ($0.42)

API 엔드포인트

POST/v1/generate새 비디오 생성

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

요청 본문

Parameter	유형	필수	설명
`prompt`	string	필수	생성할 비디오의 텍스트 설명 (최대 2000자)
`aspect_ratio`	string	선택 사항	출력 종횡비. 지원: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 (기본값: 1:1)
`resolution`	string	선택 사항	비디오 해상도: "480p" 또는 "720p" (기본값: 720p)
`duration`	string	선택 사항	비디오 길이(초): "4", "8" 또는 "12" (기본값: 8)
`generate_audio`	boolean	선택 사항	비디오에 대한 AI 오디오 생성 활성화 (기본값: false)
`fixed_lens`	boolean	선택 사항	카메라를 고정하여 모션 블러 감소 (기본값: false)
`image_urls`	string[]	선택 사항	이미지-비디오 생성을 위한 참조 이미지 URL 배열 (최대 1개)
`callback_url`	string	선택 사항	비동기 상태 알림을 위한 Webhook URL. 공개적으로 접근 가능해야 합니다.

텍스트에서 비디오

json

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

이미지에서 비디오

json

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

오디오 생성 포함

json

{
  "prompt": "A peaceful river flowing through a forest with birds singing",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8",
  "generate_audio": true,
  "fixed_lens": true
}

응답

Task created successfully

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "IN_PROGRESS"
  }
}

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

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

쿼리 매개변수

Parameter	유형	필수	설명
`task_id`	string	필수	생성 엔드포인트에서 반환된 고유 작업 ID

요청 예시

bash

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

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

javascript

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

응답

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "SUCCESS",
    "consumed_credits": 28,
    "created_at": "2026-02-07T10:30:00Z",
    "request": {
      "prompt": "A majestic eagle soaring through golden sunset clouds",
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": "8"
    },
    "response": [
      "https://cdn.example.com/videos/seed15abc123def456pro.mp4"
    ],
    "error_message": null
  }
}

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`	서버 오류입니다. 나중에 다시 시도해주세요