Volcengine에서 Seedance 이전

이미 Volcengine 형식 Seedance 요청을 보내는 애플리케이션을 위한 가이드입니다. Action 이름, Version=2024-01-01, content[], PascalCase 소재 본문, Volcengine 응답 envelope을 유지할 수 있습니다. 변경해야 하는 것은 엔드포인트와 인증 방식입니다.

변경 사항

항목	기존 Volcengine 클라이언트	TokenLab
기본 URL	`Volcengine API`	`https://api.tokenlab.sh/`
인증	`AK/SK`	`Authorization: Bearer <TOKENLAB_API_KEY>`
Action 요청	`Action`, `Version`	`Action`, `Version`
작업 본문	`content[]`	`content[]`
소재 본문	`PascalCase`	`PascalCase`
비동기 결과	`작업 ID`	`cgt-...` + 폴링

AK/SK 서명만 있는 요청은 401 InvalidCredential을 반환합니다. Action 클라이언트는 POST /?Action=...&Version=2024-01-01을 사용할 수 있고, POST /api/v3?Action=...&Version=2024-01-01도 계속 지원됩니다. REST 작업 클라이언트는 /api/v3/contents/generations/tasks를 사용합니다.

요청 형식과 작업 수명 주기

이미 Volc 스타일 Seedance 요청을 보내는 통합이라면 /v1/videos/generations 형식으로 바꾸지 않고 호환 엔드포인트를 사용할 수 있습니다. TokenLab API Key를 Authorization: Bearer ...로 보내고, REST 생성은 POST /api/v3/contents/generations/tasks, Action 스타일은 /api/v3?Action=CreateContentsGenerationsTasks&Version=2024-01-01를 사용하세요. 생성 응답은 cgt-... 작업 ID를 반환하며 상태 응답은 queued, running, succeeded, failed, cancelled, expired를 사용합니다. 이 호환 엔드포인트는 content[]의 text, image_url, video_url, audio_url, draft_task를 받습니다. first_frame, last_frame, reference_image 같은 이미지 역할은 유지됩니다. callback_url은 아직 지원하지 않으므로 작업 엔드포인트를 폴링하세요.

참고 페이지

작업 Action

Action	항목	JSON
`CreateContentsGenerationsTasks`	비디오 작업 생성	`model`, `content[]`
`GetContentsGenerationsTask`	작업 하나 조회	`TaskId`
`ListContentsGenerationsTasks`	작업 목록 조회	필터, 페이지네이션
`DeleteContentsGenerationsTasks`	작업 취소 또는 삭제	`TaskId`

최소 Action 예시

curl 'https://api.tokenlab.sh/?Action=CreateContentsGenerationsTasks&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"seedance-2.0",
    "content":[
      {"type":"text","text":"A cinematic product reveal"},
      {"type":"image_url","role":"reference_image","image_url":{"url":"https://example.com/reference.png"}}
    ],
    "ratio":"16:9",
    "duration":5,
    "resolution":"720p"
  }'

소재 및 실존 인물 인증

같은 Action 엔드포인트에서 10개의 소재 및 소재 그룹 작업도 지원합니다. PascalCase 본문, 필터, 페이지네이션, 응답 envelope, 12시간 소재 URL은 Volcengine 호환 소재 Action을 참조하세요. 실존 인물 소재는 업로드 전에 시각 인증 세션 생성과 시각 인증 결과 조회도 필요합니다.

이전 체크리스트

API 호스트를 https://api.tokenlab.sh로 변경합니다.
AK/SK 서명을 TokenLab Bearer API Key로 교체합니다.
기존 Action, 버전, 본문 대소문자를 유지합니다.
관련 소재 및 인물 인증 요청에 같은 ProjectName을 사용합니다.
TokenLab이 반환한 작업, 그룹, 소재 ID를 저장합니다.
프로덕션 트래픽 이전 전에 생성, 폴링, 목록, 오류 응답을 검증합니다.

시작하기

핵심 가이드

미디어 가이드

Volcengine에서 Seedance 이전

변경 사항

요청 형식과 작업 수명 주기

참고 페이지

작업 Action

최소 Action 예시

소재 및 실존 인물 인증

이전 체크리스트

​변경 사항

​요청 형식과 작업 수명 주기

​참고 페이지

​작업 Action

​최소 Action 예시

​소재 및 실존 인물 인증

​이전 체크리스트

변경 사항

요청 형식과 작업 수명 주기

참고 페이지

작업 Action

최소 Action 예시

소재 및 실존 인물 인증

이전 체크리스트