API 개요

Seedance 2.0 Open API의 인증 방식, 요청 흐름, 상태 조회, Webhook 사용법을 설명합니다.

Seedance 2.0 Open API를 사용하면 자체 제품에서 비동기 비디오 생성 작업을 제출하고 완료 후 결과를 가져올 수 있습니다.

Base URL

https://www.seedance2.ink

Authentication

모든 Open API 요청은 Seedance 대시보드에서 생성한 Bearer 토큰을 사용합니다.

Authorization: Bearer sd2_live_your_api_key

{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

연동 절차

Seedance 대시보드에서 API Key를 생성합니다.
POST /api/open/v1/video/generations 로 작업을 제출합니다.
반환된 requestId 를 저장합니다.
GET /api/open/v1/video/generations/{requestId} 를 폴링합니다.
필요하다면 Webhook 으로 완료 알림을 받습니다.

핵심 엔드포인트

Method	Endpoint	Description
`GET`	`/api/open/v1/models`	사용 가능한 모델, 길이, 비율, 해상도, 가격 정보를 조회합니다.
`POST`	`/api/open/v1/video/generations`	새 비디오 생성 작업을 생성합니다.
`GET`	`/api/open/v1/video/generations/{requestId}`	작업 상태를 조회하고 완료 시 출력 URL을 가져옵니다.
`POST`	`/api/open/v1/video/generations/{requestId}/cancel`	대기 중이거나 처리 중인 작업을 취소합니다.

Available Models

Model	Best for	Supported durations	Resolutions
`seedance-2.0`	Highest quality, multimodal generation	`4`-`15` seconds	`480p`, `720p`, `1080p`
`seedance-2.0-fast`	Faster turnaround	`4`-`15` seconds	`480p`, `720p`, `1080p`
`seedance-1.5-pro`	Lower-cost fallback workloads	`5` or `10` seconds	`480p`, `720p`, `1080p`

Supported aspect ratios:

16:9
9:16
1:1

상태 값

Status	Description
`queued`	요청이 접수되어 대기열에 있습니다.
`processing`	작업이 현재 실행 중입니다.
`succeeded`	작업이 성공적으로 완료되었고 `output.url` 을 사용할 수 있습니다.
`failed`	작업이 실패했습니다. `error` 를 확인하세요.
`cancelled`	작업이 완료 전에 취소되었습니다.

Models Endpoint Example

curl https://www.seedance2.ink/api/open/v1/models

{
  "success": true,
  "data": [
    {
      "id": "seedance-2.0",
      "type": "video_generation",
      "mode": "image_to_video",
      "durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
      "aspectRatios": ["16:9", "9:16", "1:1"],
      "resolutions": ["480p", "720p", "1080p"],
      "usdPerSecond": {
        "480p": 0.05,
        "720p": 0.1,
        "1080p": 0.2
      }
    }
  ]
}

Webhook

요청별 webhookUrl 을 지정하거나 API Key 수준의 기본 콜백 URL 을 설정할 수 있습니다.

둘 다 있으면 요청별 webhookUrl 이 우선합니다.
Webhook Secret 을 설정한 경우 x-seedance-signature 헤더가 포함됩니다.
Webhook 은 작업이 종료 상태에 도달했을 때만 전송됩니다.

x-seedance-signature: <hex_sha256_hmac>

{
  "success": true,
  "requestId": "req_1234567890",
  "status": "succeeded",
  "output": {
    "type": "video",
    "url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
  },
  "error": null
}

오류 코드

HTTP status	Error code	Description
`400`	`invalid_request`	요청 본문이 스키마와 맞지 않습니다.
`401`	`unauthorized`	API Key 가 없거나 올바르지 않습니다.
`402`	`insufficient_credits`	크레딧 부족으로 작업을 생성할 수 없습니다.
`404`	`not_found`	현재 API Key 에서 해당 작업을 찾을 수 없습니다.
`429`	`rate_limited`	분당 제한 또는 월간 한도를 초과했습니다.
`500`	`internal_error`	서버 측의 예기치 않은 오류입니다.

다음 단계

텍스트로 비디오 보기
이미지로 비디오 보기

Seedance 2.0 Open API를 사용하면 자체 제품에서 비동기 비디오 생성 작업을 제출하고 완료 후 결과를 가져올 수 있습니다.

Base URL

https://www.seedance2.ink

Authentication

모든 Open API 요청은 Seedance 대시보드에서 생성한 Bearer 토큰을 사용합니다.

Authorization: Bearer sd2_live_your_api_key

{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

연동 절차

Seedance 대시보드에서 API Key를 생성합니다.
POST /api/open/v1/video/generations 로 작업을 제출합니다.
반환된 requestId 를 저장합니다.
GET /api/open/v1/video/generations/{requestId} 를 폴링합니다.
필요하다면 Webhook 으로 완료 알림을 받습니다.

핵심 엔드포인트

Method	Endpoint	Description
`GET`	`/api/open/v1/models`	사용 가능한 모델, 길이, 비율, 해상도, 가격 정보를 조회합니다.
`POST`	`/api/open/v1/video/generations`	새 비디오 생성 작업을 생성합니다.
`GET`	`/api/open/v1/video/generations/{requestId}`	작업 상태를 조회하고 완료 시 출력 URL을 가져옵니다.
`POST`	`/api/open/v1/video/generations/{requestId}/cancel`	대기 중이거나 처리 중인 작업을 취소합니다.

Available Models

Model	Best for	Supported durations	Resolutions
`seedance-2.0`	Highest quality, multimodal generation	`4`-`15` seconds	`480p`, `720p`, `1080p`
`seedance-2.0-fast`	Faster turnaround	`4`-`15` seconds	`480p`, `720p`, `1080p`
`seedance-1.5-pro`	Lower-cost fallback workloads	`5` or `10` seconds	`480p`, `720p`, `1080p`

Supported aspect ratios:

16:9
9:16
1:1

상태 값

Status	Description
`queued`	요청이 접수되어 대기열에 있습니다.
`processing`	작업이 현재 실행 중입니다.
`succeeded`	작업이 성공적으로 완료되었고 `output.url` 을 사용할 수 있습니다.
`failed`	작업이 실패했습니다. `error` 를 확인하세요.
`cancelled`	작업이 완료 전에 취소되었습니다.

Models Endpoint Example

curl https://www.seedance2.ink/api/open/v1/models

{
  "success": true,
  "data": [
    {
      "id": "seedance-2.0",
      "type": "video_generation",
      "mode": "image_to_video",
      "durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
      "aspectRatios": ["16:9", "9:16", "1:1"],
      "resolutions": ["480p", "720p", "1080p"],
      "usdPerSecond": {
        "480p": 0.05,
        "720p": 0.1,
        "1080p": 0.2
      }
    }
  ]
}

Webhook

요청별 webhookUrl 을 지정하거나 API Key 수준의 기본 콜백 URL 을 설정할 수 있습니다.

둘 다 있으면 요청별 webhookUrl 이 우선합니다.
Webhook Secret 을 설정한 경우 x-seedance-signature 헤더가 포함됩니다.
Webhook 은 작업이 종료 상태에 도달했을 때만 전송됩니다.

x-seedance-signature: <hex_sha256_hmac>

{
  "success": true,
  "requestId": "req_1234567890",
  "status": "succeeded",
  "output": {
    "type": "video",
    "url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
  },
  "error": null
}

오류 코드

HTTP status	Error code	Description
`400`	`invalid_request`	요청 본문이 스키마와 맞지 않습니다.
`401`	`unauthorized`	API Key 가 없거나 올바르지 않습니다.
`402`	`insufficient_credits`	크레딧 부족으로 작업을 생성할 수 없습니다.
`404`	`not_found`	현재 API Key 에서 해당 작업을 찾을 수 없습니다.
`429`	`rate_limited`	분당 제한 또는 월간 한도를 초과했습니다.
`500`	`internal_error`	서버 측의 예기치 않은 오류입니다.

다음 단계

텍스트로 비디오 보기
이미지로 비디오 보기

Base URL

Authentication

연동 절차

핵심 엔드포인트

Available Models

상태 값

Models Endpoint Example

Webhook

오류 코드

다음 단계

목차

API 개요

Base URL

Authentication

연동 절차

핵심 엔드포인트

Available Models

상태 값

Models Endpoint Example

Webhook

오류 코드

다음 단계

목차