메인 콘텐츠로 건너뛰기
GET
/
grok
/
v1
/
videos
/
{request_id}
Query an xAI video job
curl --request GET \
  --url https://api.cometapi.com/grok/v1/videos/{request_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3",
    "action": "VIDEO_GENERATION",
    "status": "SUCCESS",
    "fail_reason": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
    "submit_time": 1773297002,
    "start_time": 0,
    "finish_time": 1773297014,
    "progress": "100%",
    "data": {
      "model": "grok-imagine-video",
      "usage": {
        "cost_in_usd_ticks": 500000000
      },
      "video": {
        "url": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-72924fdc-e6d7-4885-b318-8a367aaa9a02.mp4",
        "duration": 1,
        "respect_moderation": true
      },
      "status": "done"
    }
  }
}
이 엔드포인트는 이미 request_id를 가지고 있을 때 사용합니다. xAI 작업이 아직 실행 중인지 알려주고, 준비가 되면 최종 비디오 메타데이터를 반환합니다.

​
먼저 확인할 필드

  • 최상위 오류를 위한 래퍼 code 및 message
  • CometAPI 작업 상태를 위한 data.status
  • 중첩된 provider 상태를 위한 data.data.status
  • 렌더링이 완료되었을 때의 data.data.video.url

​
폴링 루프

1

먼저 비디오를 생성하거나 편집합니다

비디오 생성 또는 비디오 편집부터 시작한 다음, 반환된 request_id를 복사합니다.
2

중첩 상태가 완료될 때까지 계속 폴링합니다

래퍼 실패와 provider 수준 실패를 구분할 수 있도록 래퍼와 중첩된 provider 필드를 모두 확인하세요.
3

완료된 파일을 저장합니다

생성된 URL은 임시라고 xAI 문서에 명시되어 있으므로 최종 video.url을 즉시 다운로드하거나 복사하세요.

​
CometAPI에서 기대할 수 있는 동작

이 단계는 xAI가 공식 워크플로에서 설명하는 것과 동일한 폴링 단계입니다. CometAPI는 provider 페이로드를 감싸는 래퍼 엔벌로프를 추가하여, provider 전반에서 비동기 작업을 더 일관되게 처리할 수 있도록 합니다.

인증

​
Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

경로 매개변수

​
request_id
string
필수

Deferred request id returned by the create or edit endpoint.

응답

200 - application/json

Current task state.

​
code
string
필수
​
message
string
필수
​
data
object
필수