메인 콘텐츠로 건너뛰기
GET
/
v1
/
videos
/
{video_id}
Retrieve a Sora video job
curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "size": "1280x720",
  "error": null,
  "model": "sora-2",
  "object": "video",
  "prompt": "A paper airplane glides across a desk.",
  "status": "in_progress",
  "seconds": "4",
  "progress": 0,
  "created_at": 1773296991,
  "expires_at": null,
  "completed_at": null,
  "remixed_from_video_id": null
}
Sora 작업을 시작한 후 이 엔드포인트를 사용하세요. 현재 작업 상태, 설정된 크기와 재생 시간, 그리고 provider가 반환한 오류를 확인할 수 있습니다.

다음 필드를 확인하세요

  • 수명 주기 상태를 확인하려면 status
  • 대략적인 진행 신호를 확인하려면 progress
  • provider가 작업을 거부했거나 실패했을 때는 error
  • 임시 자산이 언제 만료되는지 알아야 한다면 완료 후 expires_at

완료될 때까지 폴링하세요

1

먼저 비디오를 생성하거나 리믹스하세요

비디오 생성 또는 비디오 리믹스로 시작하세요.
2

id로 폴링하세요

반환된 id를 여기로 전달하고 작업이 completed 또는 failed 상태에 도달할 때까지 계속 확인하세요.
3

파일을 다운로드하세요

작업이 completed 상태가 되면 비디오 콘텐츠 조회로 이동하세요.

CometAPI의 응답 형태

이 단계는 Sora 폴링 워크플로와 매우 유사합니다. CometAPI는 OpenAI 스타일의 객체 형태를 유지하므로 최소한의 변환만으로 상태 확인을 연결할 수 있습니다.

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

경로 매개변수

video_id
string
필수

Video id returned by the create or remix endpoint.

응답

200 - application/json

Current job state.

id
string
필수
size
string
필수
model
string
필수
object
string
필수
status
string
필수
seconds
string
필수
progress
integer
필수
created_at
integer
필수
error
object
prompt
string
expires_at
integer | null
completed_at
integer | null
remixed_from_video_id
string | null