Seedance 1.5 Pro 비동기 비디오 생성

API 문서

이 엔드포인트를 사용하여 Seedance 1.5 Pro 작업을 제출하고 상태를 확인하세요. 각 호출은 길이와 오디오(동기화된 대화, 효과음, 음악) 유무에 따라 크레딧을 소모합니다.

인증

모든 요청은 API 키를 헤더에 포함해야 합니다. Authorization header:

Authorization: Bearer <YOUR_API_KEY>

누락되거나 유효하지 않은 키는 반환됩니다. 401 Unauthorized.

POST

https://seedance1-5pro.com/api/generate

생성 작업 생성

새로운 Seedance 1.5 Pro 작업을 제출합니다. 호출은 렌더링이 비동기적으로 완료되는 동안 즉시 task_id 를 반환합니다.

매개변수	유형	필수	설명
prompt	string (max 1000 chars)	예	메인 장면 설명 (텍스트 또는 이미지 흐름).
aspect_ratio	string	예	지원: 16:9, 9:16, 1:1. image_urls가 존재하면 무시됩니다.
duration	string	예	렌더링 길이 (초 단위) ("5" 또는 "10").
sound	boolean	아니요	클립에 오디오 포함 (동기화된 대화, 효과음, 음악).
image_urls	string[]	아니요	선택적 참조 이미지 URL (이미지-투-비디오에 필요).

크레딧 소비

크레딧은 작업이 생성될 때 차감됩니다. 실패한 작업은 자동으로 환불됩니다.

사전 설정	차감된 크레딧
5초 (무음)	65
10초 (무음)	130
5초 (오디오 포함)	130
10초 (오디오 포함)	260

요청 예시

{
  "prompt": "Drone shot over neon night market",
  "aspect_ratio": "16:9",
  "duration": "5",
  "sound": false,
  "image_urls": [
    "https://cdn.example.com/reference/frame01.png"
  ]
}

응답 예시

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd15p_b6d54c8f4b4c4e8"
  }
}

GET / POST

https://seedance1-5pro.com/api/status

작업 상태 확인

이 엔드포인트를 사용하여 최신 기록을 폴링하세요. 작업이 여전히 IN_PROGRESS(진행 중) 상태일 때는 응답하기 전에 공급자에게 한 번 더 쿼리합니다.

매개변수	유형	필수	설명
task_id	string	예	/generate에서 반환된 ID. 쿼리 (?task_id=) 또는 JSON 본문을 통해 전송합니다.

필드	설명
task_id	/generate에서 반환된 ID.
status	SUCCESS (성공)
request	제출된 페이로드의 정리된 복사본.
response	상태가 SUCCESS일 때의 미디어 URL 배열.
consumed_credits	작업에 청구된 크레딧 (환불 시 0).
error_message	상태가 FAILED일 때의 공급자 오류 메시지.
created_at	작업이 저장된 UTC 타임스탬프.

요청 예시

GET https://seedance1-5pro.com/api/status?task_id=sd15p_b6d54c8f4b4c4e8
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://seedance1-5pro.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "sd15p_b6d54c8f4b4c4e8"
}

응답 예시

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd15p_b6d54c8f4b4c4e8",
    "status": "SUCCESS",
    "request": {
      "prompt": "Drone shot over neon night market",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": false
    },
    "response": [
      "https://static.gogloai.com/seedance15pro/clip_001.mp4"
    ],
    "consumed_credits": 65,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

오류 처리

401 Unauthorized - API 키 누락 또는 유효하지 않음.
402 Payment Required - 크레딧 잔액이 차감액을 충당할 수 없음.
429 Too Many Requests - 폴링 간격 또는 요청 속도를 줄이십시오.
500 - 일시적인 문제; 지수 백오프를 사용하여 다시 시도하십시오.