Skip to main content
GET
cURL
이미 request_id를 받은 후 이 엔드포인트를 사용하세요. xAI 작업이 아직 실행 중인지 알려 주고, 준비되면 최종 비디오 메타데이터를 반환합니다.

먼저 확인할 필드

  • request_id 작업이 수락되었지만 결과가 아직 준비되지 않은 경우
  • status xAI 작업 상태에 사용합니다. pending인 동안 계속 폴링하고, done, failed 또는 expired 상태에서는 중지하세요.
  • progress 반환되는 경우 완료 비율에 사용합니다
  • video.url 렌더링이 완료되면

폴링 루프

1

먼저 비디오를 생성하거나 편집하세요

먼저 xAI 비디오 생성 또는 xAI 비디오 편집 생성을 사용한 다음, 반환된 request_id를 복사합니다.
2

작업이 종료 상태에 도달할 때까지 폴링하세요

응답이 request_id만 그대로 반환하면 몇 초 기다린 뒤 다시 폴링하세요. statuspending인 동안 계속하고, done, failed 또는 expired 상태에서는 중지하세요.
3

완료된 파일을 저장하세요

xAI 문서에서는 생성된 URL을 임시 URL로 안내하므로, 최종 video.url를 즉시 다운로드하거나 복사하세요.

인증

Authorization
string
header
필수

Use your CometAPI API key as the bearer value.

경로 매개변수

request_id
string
필수

The deferred request ID returned by the create or edit endpoint.

응답

200 - application/json

The current Grok video task state.

request_id
string

Returned when the request is accepted but result metadata is not ready yet.

model
string

The Grok video model ID.

video
object

Generated video metadata. Present when the job has completed.

status
enum<string>

The job state. done means the video metadata is ready.

사용 가능한 옵션:
pending,
done,
failed,
expired
progress
integer

Completion percentage when returned.

usage
object

Additional usage metadata returned when the job is complete. Its contents can vary by model.

error

Error details when the job fails.

마지막 수정일 2026년 8월 21일