제출 후 Seedance 동영상 작업을 취소할 수 있나요?

​

간단한 답변

​

공개 엔드포인트 및 작업 상태

queued → running → succeeded / failed / expired

• queued: 작업이 생성되었으며 대기열에서 대기 중입니다.
• running: 작업이 처리 중입니다.
• succeeded: 동영상 생성이 성공적으로 완료되었습니다.
• failed: 작업 처리에 실패했습니다.
• expired: 작업이 실행 시간 윈도우를 초과하여 만료되었습니다.

content.video_url

​

What should I do after submitting a task?

​

Step 1: Save the task ID and request details

• The model name;
• The prompt or a prompt summary;
• Important parameters such as duration, resolution, and aspect ratio;
• The submission time;
• The request ID;
• The business ID in your own system.

​

Step 2: Query the original task

• Waiting about 20–30 seconds after submission before the first query;
• Querying every 10–20 seconds afterward;
• Not resubmitting immediately just because the video is not available yet.

curl "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks/YOUR_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

• YOUR_TASK_ID: The task ID returned by the task-creation endpoint;
• YOUR_API_KEY: An API key created in the APIYI console.

​

Step 3: Handle each task status

• queued: The task is still waiting; continue waiting and querying.
• running: The task is still generating; continue waiting and querying.
• succeeded: Download the video from content.video_url immediately.
• failed: Inspect the error information in the response.
• expired: Review the task details and call logs to determine why it expired.

​

Step 4: Confirm the task status after a client timeout

1. Check whether the client response already contains a task_id.
2. Check whether the console call logs contain a task record.
3. If a task_id exists, query the original task first.
4. If no task_id is visible yet, do not conclude from the network error alone that no task was created.
5. If you cannot confirm whether the task was created, ask support to verify it before retrying.

​

중복 제출을 방지하려면 어떻게 해야 하나요?

• 각 요청에 고유한 비즈니스 ID를 생성합니다.
• 비즈니스 ID와 Seedance task_id 간의 매핑을 저장합니다.
• 사용자가 요청을 제출한 후 제출 버튼을 일시적으로 비활성화합니다.
• 클라이언트 타임아웃 또는 프로세스 종료 후에는 원래 작업을 조회하여 재개합니다.
• prompt, 모델, 기간, 종횡비 및 참조 자료 세부 정보를 저장합니다.
• 원래 작업이 존재하지 않거나 명확하게 실패했음을 확인한 후에만 새로 제출합니다.
• 진행 중 상태와 종료 상태를 구분합니다. queued 또는 running를 실패로 간주하지 마십시오.

Create task: execute once
Save task_id: write it to a database or task record
Query task: poll by task_id
Recover process: read the saved task_id and continue querying

​

중복 제출 후 과금을 어떻게 조정해야 합니까?

Pre-charge when the task is submitted → refund the difference or settle the final amount after completion

• 클라이언트의 타임아웃
• 네트워크 연결 끊김
• failed
• expired
• 클라이언트가 완전한 응답을 수신하지 못한 경우
• 서버에서 작업을 생성했을 수 있음에도 클라이언트에 요청 실패가 표시되는 경우

• 관련된 모든 Seedance task_id 값
• 해당 요청 ID
• 제출 시간
• 모델 이름
• 중요한 요청 매개변수
• 콘솔 호출 로그
• 과금 또는 청구 기록의 스크린샷

​

자주 묻는 질문

​

폴링을 중지하면 Seedance 작업도 자동으로 중지됩니까?

​

요청 시간 초과 후 즉시 재시도해도 됩니까?

• 응답에 task_id이 포함되어 있는지 여부
• 콘솔 호출 로그에 작업 레코드가 있는지 여부
• 원본 작업의 현재 상태
• 해당 과금 레코드가 이미 존재하는지 여부

​

실패 또는 만료 상태라고 해서 항상 과금되지 않았다는 의미입니까?

​

유효하지 않은 매개변수로 인해 발생한 HTTP 400에는 과금됩니까?

• 유효하지 않은 매개변수 형식
• 지원되지 않는 해상도
• 유효하지 않은 화면 비율
• 지원되지 않는 동영상 길이
• 호환되지 않는 모델 및 매개변수 조합

​

생성된 동영상 URL을 얼마나 오래 보관할 수 있습니까?

​

관련 문서

• Seedance 2.0 동영상 생성 API
• Seedance 2.0 동영상 생성 개요
• 모델 오류는 어떻게 문제 해결해야 합니까?

​

지원팀 문의

• queued 또는 running 상태가 비정상적으로 오래 지속되는 경우
• 클라이언트 타임아웃 후 작업이 생성되었는지 확인할 수 없는 경우
• 중복 제출 후 여러 작업이 생성된 경우
• 작업 상태와 과금 기록이 일치하지 않는 경우
• 작업은 성공했지만 동영상을 반환하지 않거나 다운로드할 수 없는 경우

• Seedance task_id
• 요청 ID
• 제출 시간
• 모델 이름
• 주요 요청 매개변수
• 콘솔 호출 로그
• 관련 과금 기록