asset:// 자산 ID를 받은 다음 생성 요청에서 해당 ID를 참조해야 합니다. 요청 본문은 메가바이트 단위에서 수십 바이트로 줄어들고, 작업 생성 엔드포인트는 즉시 반환되며, 미디어의 콘텐츠 검사는 대신 수집 시점에 수행됩니다.이 페이지에서는 제출 속도와 안정성을 다룹니다. 자산 라이브러리의 엔드포인트별 문서는 자산 라이브러리를 참조하고, 처음부터 끝까지 실행할 수 있는 코드는 자산 참조 가이드를 참조하시기 바랍니다.먼저 확인할 사항: 제출이 느린 것입니까, 아니면 생성이 느린 것입니까?
Seedance는 비동기 태스크 기반 API입니다. 하나의 클립은 서로 다른 두 단계로 구성되며, 각 단계의 지연 시간은 완전히 다른 원인에서 발생합니다.미디어를 전달하는 세 가지 방법 비교
동일한 이미지라도 제출 시점에는 세 가지 옵션이 매우 다르게 동작합니다.asset:// 참조를 사용하면 이 비용을 처음 수집 단계에서 한 번만 부담하게 되며, 이후의 모든 생성 요청에서는 짧은 문자열만 전송합니다.
에셋 우선 방식은 단지 더 빠르기만 한 것이 아닙니다
제출 시간이 파일 크기와 분리됩니다
재시도 비용이 거의 들지 않습니다
콘텐츠 검사가 더 일찍 수행됩니다
Active까지 폴링되므로, 규정을 준수하지 않는 항목은 생성 태스크가 중간에 실패하는 대신 바로 해당 단계에서 확인됩니다.에셋을 재사용할 수 있습니다
asset://로 참조해야 합니다. 에셋 라이브러리를 참조하십시오.
세 단계로 마이그레이션
미디어를 수집하고 자산 ID를 가져옵니다
Active이 되고 자산을 사용할 수 있을 때까지 폴링합니다(단일 이미지의 경우 약 13초).자산 라이브러리는 Seedance API에서 무료이며 연회비가 없습니다.생성 요청에서 인라인 데이터를 asset://으로 교체합니다
content 구조, role 값 및 기타 모든 매개변수는 동일하게 유지됩니다. image_url.url의 값만 데이터 URL에서 asset://<Id>으로 변경됩니다. 프롬프트에서 미디어를 전달한 순서에 따라 “이미지 1”, “이미지 2”로 참조하십시오. 프롬프트 텍스트에 자산 ID를 입력하지 마십시오.자산 ID를 자체 데이터베이스에 저장합니다
첫 프레임/마지막 프레임 작업은 어떻게 처리합니까?
첫 프레임/마지막 프레임(role: "first_frame" / "last_frame")과 멀티모달 참조(role: "reference_image")는 의미 체계가 서로 다른 상호 배타적인 입력 모드이므로, 아무 생각 없이 서로 바꿔 사용하지 마십시오.
- 정확한 시작 프레임과 종료 프레임이 실제로 필요한 경우 — 예를 들어 이전 클립과 끊김 없이 이어 붙여야 하는 경우 — 첫 프레임/마지막 프레임 모드를 유지하고 인라인 데이터 URL을 공개 URL로 교체하십시오. 요청 본문 크기가 즉시 수 메가바이트에서 수백 바이트로 줄어들며, 남은 가져오기 비용은 업스트림으로 이동합니다. 빠르고 인증이 필요 없으며 충분한 용량이 확보된 곳에 이미지를 호스팅하십시오.
- 실제로 필요한 것이 일관된 캐릭터 또는 장면인 경우 그리고 경계 프레임이 픽셀 단위로 정확히 일치할 필요가 없다면,
asset://에셋 ID를 사용한 멀티모달 참조 생성으로 전환하십시오. 이것이 가장 안정적인 경로이며 이 페이지에서 권장하는 방식입니다.
참조 동영상 및 오디오
참조 동영상(role: "reference_video")은 이미지보다 훨씬 크므로 인라인 Base64가 제출 시간 초과의 가장 유력한 원인입니다. 다음과 같이 사용하지 않는 것이 좋습니다.
- 공개 URL을 사용하는 것이 좋습니다. 빠르고, 인증이 필요 없으며, 충분한 리소스가 제공되는 곳에서 호스팅해야 합니다.
- 인증된 사용자용 에셋 그룹은 에셋 라이브러리의 신원 확인 플로를 통해 동영상과 오디오를 수집할 수 있습니다(동영상: mp4 / mov, 2
15초, 50MB 미만; 오디오: mp3 / wav, 215초, 15MB 미만). - 참고할 점은 다음과 같습니다. 참조 동영상이 포함된 작업에는 더 낮은 가격 등급이 적용됩니다. 동영상 입력이 있는 경우 토큰 100만 개당 $7.56이며, 없는 경우에는 $12.60입니다. 개요의 모델 가격을 참조하십시오.
타임아웃 후 수행할 작업
작업 생성 POST가 타임아웃되면 클라이언트는 작업이 생성되었는지 알 수 없습니다. 응답 헤더가 도착하지 않았으므로 조회할 작업 ID가 없습니다. 다음 순서대로 처리합니다.무엇이든 다시 보내기 전에 기록을 확인합니다
읽기 타임아웃과 미디어 전송 방식을 함께 변경합니다
asset://를 사용한다면 작업 생성 요청의 30–60초 타임아웃으로 충분합니다. 비동기 엔드포인트 자체는 빠르고 실제 작업은 작업 측에서 수행되기 때문입니다. 대용량 미디어를 계속 인라인으로 전송해야 한다면 연결 타임아웃과 읽기 타임아웃을 별도로 설정하고, 파일 크기와 업로드 대역폭을 기준으로 읽기 타임아웃을 정합니다.추가로 조사하기 전에 동시 실행 수를 줄입니다
Base URL을 확인합니다
FAQ
텍스트-투-동영상에도 에셋 라이브러리가 필요합니까?
텍스트-투-동영상에도 에셋 라이브러리가 필요합니까?
ingest 자체에는 얼마나 걸립니까? 단순히 비용을 다른 곳으로 옮기는 것 아닙니까?
ingest 자체에는 얼마나 걸립니까? 단순히 비용을 다른 곳으로 옮기는 것 아닙니까?
Active에 도달하는 데 약 13초가 걸립니다 — 수동 검토 없이 완전히 자동으로 처리됩니다.핵심은 한 번만 처리된다는 점입니다. 이후에는 동일한 에셋을 무기한 참조할 수 있지만, 인라인 업로드에서는 생성할 때마다 전체 전송을 반복합니다. 생성하는 클립이 많아질수록 그 차이는 더욱 커집니다.에셋 ID는 만료됩니까?
에셋 ID는 만료됩니까?
에셋 라이브러리를 사용하면 추가 비용이 발생합니까?
에셋 라이브러리를 사용하면 추가 비용이 발생합니까?
생성된 동영상 URL은 얼마나 오래 유효합니까?
생성된 동영상 URL은 얼마나 오래 유효합니까?
content.video_url은 24시간 동안 유효한 서명된 직접 링크입니다. 작업이 성공하는 즉시 파일을 자체 스토리지로 복사하고, 해당 URL을 영구 주소로 배포하지 마십시오.에셋 라이브러리 KEY는 Seedance token과 동일합니까?
에셋 라이브러리 KEY는 Seedance token과 동일합니까?
SeeDance2 그룹을 선택해야 하며, 동영상 생성 API에만 사용합니다.