동영상 다운로드

공개 작업 ID로 완료된 동영상을 다운로드합니다. 플랫폼 API Key가 필요하며 응답은 JSON이 아닌 바이너리입니다.

GET/v1/videos/{task_id}/content

인증

bearerAuth

인증Bearer <token>

플랫폼 API Key 사용: Authorization: Bearer your-api-key.

전달 위치: header

task_id*string

플랫폼이 반환한 공개 작업 ID입니다. 문자열로 저장하고 조회·다운로드에 사용하세요. request_id나 중첩된 업스트림 작업 ID를 사용하지 마세요.

길이1 <= length

curl -X GET "https://api.agtcloud.cn/v1/videos/TASK_ID/content" \
  -H "Authorization: Bearer your-api-key" \
  --output video.mp4

응답 예시가 없습니다

동영상 바이너리 응답입니다. 실제 Content-Type에 따라 저장하며 JSON 예시는 없습니다.

플랫폼 조회로 status: "completed", 또는 네이티브 조회로 output.task_status: "SUCCEEDED"를 확인합니다.
생성에서 반환된 공개 작업 ID를 경로에 넣고 해당 사이트의 같은 사용자 API Key를 사용합니다.
실제 Content-Type에 따라 저장합니다. cURL 예시는 --output video.mp4로 파일에 기록합니다.

다운로드는 새 작업을 생성하지 않습니다. 조회의 metadata.url 또는 output.video_url에서 직접 저장할 수도 있습니다. 주소가 만료되기 전에 저장하세요.

미완료 작업은 HTTP 400, 없거나 접근 불가능한 작업은 HTTP 404일 수 있습니다. 오류는 error 객체를 포함한 JSON일 수 있습니다. 오류 파일을 동영상으로 오인하지 않도록 HTTP 상태와 콘텐츠 유형을 확인하세요.