메인 콘텐츠로 건너뛰기
GET
/
v1
/
videos
/
{video_id}
/
content
Download finished Sora video content
curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id}/content \
  --header 'Authorization: Bearer <token>'
"<string>"
작업이 completed 상태에 도달한 후 이 엔드포인트를 사용해 완성된 Sora 출력을 다운로드하세요. 그전까지는 비디오 파일 대신 오류가 반환됩니다.

​
다운로드 전에

  • Retrieve Video에서 status: completed가 보고될 때까지 기다리세요
  • 생성 또는 remix 단계에서 받은 video_id를 전달하세요
  • 공급자의 임시 제공 기간보다 오래 보관해야 한다면 파일을 자체 버킷이나 CDN에 저장하세요

​
다운로드 흐름

1

비디오 생성 또는 remix

Create Video 또는 Remix Video로 시작하세요.
2

완료될 때까지 폴링

작업이 completed 상태에 도달할 때까지 Retrieve Video를 사용하세요.
3

바이너리 파일 가져오기

이 엔드포인트를 호출해 MP4 또는 지원되는 다른 에셋 변형을 다운로드하세요.

​
임시 제공 기간

OpenAI의 Videos API는 동일한 최종 다운로드 단계를 사용합니다. 2026-03-12의 실제 검증 과정에서 완료 전에 이 엔드포인트를 호출하면 invalid_request_error JSON 응답이 반환되었으며, 이는 렌더링이 아직 진행 중일 때 예상해야 하는 동작입니다.

인증

​
Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

경로 매개변수

​
video_id
string
필수

Completed video id.

쿼리 매개변수

​
variant
string

Optional content variant such as the main video, thumbnail, or spritesheet when supported by the provider.

응답

Binary video content.

The response is of type file.