SeedanceLink
충전로그인

개발자 문서

프롬프트에서 동영상까지 직접 연결하세요.

이 예시는 SeedanceLink를 호출합니다. 나만의 API 키를 사용하세요. Google 로그인 세션은 웹 콘솔용입니다.

이 페이지의 목차

시작하기 전에

로그인하고 견적에 충분한 잔액을 충전한 뒤, Seedance가 활성화된 그룹에서 키를 만드세요. 아래 최소 예시는 4초, 480p를 요청합니다.

내 API 키 만들기 모델 및 요금

인증

생성, 상태, 콘텐츠 요청에 Authorization: Bearer YOUR_API_KEY를 보내세요. 작업을 생성한 동일한 키를 사용해야 합니다. 키를 URL에 넣지 마세요.

Authorization: Bearer YOUR_API_KEY
API 오리진https://seedancelink.io

생략하면 길이는 5초, 해상도는 720p입니다. 이 예시는 4초와 480p를 명시적으로 선택합니다. application/json을 보내고 모델 페이지에 표시된 두 모델 ID 중 하나를 사용하세요.

동일한 macOS/Linux 터미널 또는 Windows WSL에서 curl 예시를 실행하세요. 첫 예시가 키와 이 사이트의 API 주소를 설정합니다. 키는 비공개로 유지하세요.

작업 만들기

이 예시는 4초 영상을 요청합니다. API가 반환한 id를 저장하세요. Seedance 2.0은 4–15초, Seedance 2.5는 4–30초를 지원합니다. 두 모델 모두 480p, 720p, 1080p를 지원합니다.

POST /api/v3/contents/generations/tasks
API_KEY='YOUR_API_KEY'
API_BASE='https://seedancelink.io'

curl --fail-with-body --request POST "$API_BASE/api/v3/contents/generations/tasks" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "seedance-2.0-933",
  "content": [
    {
      "type": "text",
      "text": "일출 무렵 잔잔한 호수를 가로지르는 작은 배, 영화 같은 조명."
    }
  ],
  "duration": 4,
  "resolution": "480p",
  "ratio": "16:9"
}'

응답 예제

{
  "id": "YOUR_TASK_ID",
  "status": "queued"
}

응답의 작업 ID를 저장하고 다음 두 단계에서 사용하세요.

상태 확인

REPLACE_WITH_RESPONSE_ID를 저장한 id로 바꾸세요. 대기 또는 실행 중에는 15초마다 확인하고 succeeded이면 다운로드합니다. failed 또는 needs_reconcile이면 조회를 중단하고, needs_reconcile은 지원팀에 문의하세요. 자동으로 다시 제출하지 마세요.

응답 예제

{
  "id": "YOUR_TASK_ID",
  "status": "succeeded"
}

약 15초마다 확인하세요. 상태가 succeeded가 된 후에만 다운로드하세요.

영상 다운로드

작업을 만든 키와 같은 키를 사용하세요. 보호된 엔드포인트에 Bearer 키가 필요하므로 브라우저에서 URL만 여는 것으로는 부족합니다. curl은 다른 호스트에 키를 보내지 않고 HTTPS 리디렉션을 따릅니다.

작업 상태 및 과금

queued
접수되어 대기 중입니다.
running
생성 중입니다.
succeeded
완료되었습니다. 인증이 필요한 콘텐츠 엔드포인트를 사용할 수 있습니다.
failed
생성에 실패하여 예약 금액이 반환되었습니다.
needs_reconcile
제출 결과가 불확실하여 확인을 위해 예약 금액을 유지합니다.

생성 전에 견적을 확인하세요.

요청 초수 × 해상도 요금 × 적용 배율. 제출 시 견적 금액을 예약하고, 성공 시 청구하며, 실패 시 반환합니다.

동일한 키로 다운로드

succeeded 후 API 키와 함께 content.video_url 또는 아래 콘텐츠 엔드포인트를 사용하세요. 잔액이 0이어도 이미 결제된 작업을 다운로드할 수 있습니다.

제출 결과가 불확실한 경우

needs_reconcile이 있는 202 접수 응답에도 로컬 작업 ID가 포함됩니다. 해당 ID를 보관하고 상태를 확인하세요. 원래 금액이 계속 예약되어 있으므로 다른 작업을 자동으로 생성하지 마세요.