xAI
비디오 생성
CometAPI POST /grok/v1/videos/generations를 사용해 Grok으로 비디오를 생성하고, 프롬프트로 입력 이미지를 애니메이션화하며, request_id로 결과를 폴링합니다.
POST
/
grok
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}이 엔드포인트를 사용하면 텍스트만으로, 또는 텍스트와 하나의 소스 이미지를 함께 사용해 Grok 비디오 작업을 시작할 수 있습니다.
request_id가 즉시 반환되므로 비동기 워크플로의 첫 단계로 처리해야 합니다.
작은 요청으로 시작하기
model: grok-imagine-video사용- 스모크 테스트의 경우
duration은1,resolution은480p로 유지 - image-to-video가 필요할 때만
image.url추가 - base64를 보내는 경우, 문서와 OpenAPI 예제 형식은
data:image/png;base64,<BASE64_IMAGE_DATA>로 유지
작업 흐름
완료될 때까지 폴링
중첩된 provider status가
done이 될 때까지 Get Video Generation Results를 호출합니다.CometAPI에서 달라지는 점
xAI는 비디오 생성을 시작 -> 폴링의 2단계 흐름으로 문서화합니다. CometAPI는 동일한 요청 형식과 동일한 핵심 model id를 유지하지만, CometAPI 키로 인증하고 CometAPI base URL을 사용합니다. 실제 1초 480p 요청은 2026-03-12에 성공적으로 완료되었고 실제 결과 URL을 반환했습니다.인증
Bearer token authentication. Use your CometAPI key.
본문
application/json
Prompt for the video job.
예시:
"A candle flickers on a wooden table."
Output aspect ratio.
사용 가능한 옵션:
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Output duration in seconds. xAI documents a range of 1 to 15 seconds.
Optional source image for image-to-video.
Show child attributes
Show child attributes
xAI video model id.
예시:
"grok-imagine-video"
Show child attributes
Show child attributes
Output resolution.
사용 가능한 옵션:
480p, 720p Deprecated size field. Prefer aspect_ratio and resolution.
Optional end-user identifier.
응답
200 - application/json
Request accepted.
Deferred request id used for polling.
⌘I
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}