Grok으로 동영상 만들기
텍스트, 소스 이미지 또는 이미지 및 사전 설정 음성 참조로 비동기 Grok Imagine Video 1.5 작업을 만듭니다.
curl https://api.cometapi.com/grok/v1/videos/generations \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary '{
"model": "grok-imagine-video-1.5",
"prompt": "A paper boat glides across a quiet pond at sunrise.",
"duration": 1,
"aspect_ratio": "16:9",
"resolution": "480p"
}'{
"request_id": "<request_id>"
}request_id를 반환하므로 비동기 워크플로의 첫 단계로 처리하세요.
항상 model: grok-imagine-video-1.5을 명시적으로 전송하세요. 여기에서 설명하는 1.5 요청 형식에는 model 및 prompt가 필요합니다.
입력 모드 선택
| 모드 | 요청 필드 | 규칙 |
|---|---|---|
| 텍스트-동영상 | prompt | image, reference_images 및 reference_audios. |
| 이미지-동영상 | prompt, image.url | image.url 공개 이미지 URL 또는 이미지 데이터 URI를 허용합니다. image을 참조 입력과 함께 사용하지 마세요. |
| 참조-동영상 | prompt 및 reference_images 또는 reference_audios | 참조 이미지 최대 7개와 사전 설정 음성 최대 3개를 전송하세요. 참조-동영상 출력은 720p. |
data:image/png;base64,<BASE64_IMAGE_DATA>을 사용하세요. 각 reference_images 항목은 동일한 url 필드를 사용합니다. 참조 오디오 항목은 voice_id 사전 설정을 사용하며, 예를 들어 eve과 같습니다. 프롬프트에서 <IMAGE_0> 및 <AUDIO_0> 같은 태그로 해당 참조를 식별할 수 있습니다.
작은 요청으로 시작하기
model: grok-imagine-video-1.5사용- 첫 요청에서는
duration을1로,resolution을480p로 유지하세요. - 장면과 움직임이 명확하도록
prompt을 명시적으로 지정하세요. - 참조 이미지와 음성을 결합하기 전에 입력 모드를 한 번에 하나씩 추가하세요.
길이 및 해상도
| 설정 | 지원 값 | 기본값 | 경계 동작 |
|---|---|---|---|
duration | 정수 1-15 | 8 | 첫 테스트에는 짧은 클립을 사용하세요. 긴 클립은 비용이 더 들고 완료하는 데 시간이 더 걸립니다. |
resolution | 480p, 720p, 1080p | 480p | 고해상도 요청은 비용이 더 들고 완료하는 데 시간이 더 걸립니다. 참조-동영상은 최대 720p. |
aspect_ratio | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 | 16:9 텍스트-동영상의 경우 | 이미지-동영상에서는 생략하면 소스 이미지의 가로세로 비율이 유지됩니다. |
duration, resolution 및 aspect_ratio를 명시적으로 설정하세요.
작업 흐름
작업 만들기
request_id를 저장하세요.완료 상태 폴링
status가 done, failed 또는 expired 중 하나가 될 때까지 확인하세요. 작업 메타데이터가 준비되는 동안 초기 응답에는 에코된 request_id만 포함될 수 있습니다.출력 유지
video.url를 자체 스토리지에 복사하세요.인증
Use your CometAPI API key as the bearer value.
본문
The Grok video model ID. Send this field explicitly so the request uses Grok Imagine Video 1.5.
grok-imagine-video-1.5 "grok-imagine-video-1.5"
A description of the scene, motion, and audio. Reference-to-video prompts can identify inputs with tags such as <IMAGE_0> and <AUDIO_0>.
1"A paper boat glides across a quiet pond at sunrise."
The output duration in seconds. Use an integer from 1 through 15.
1 <= x <= 15The output aspect ratio. Text-to-video uses 16:9 when omitted. Image-to-video uses the source image's aspect ratio when omitted.
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 "16:9"
The output resolution. Reference-to-video requests support 480p and 720p; text-to-video and image-to-video also support 1080p.
480p, 720p, 1080p The source image for image-to-video. Do not combine this field with reference_images or reference_audios.
Show child attributes
Show child attributes
Visual references for reference-to-video. Each item accepts a public image URL or image data URI. Do not combine this field with image.
1 - 7 elementsShow child attributes
Show child attributes
Preset voice references for reference-to-video. Do not combine this field with image.
1 - 3 elementsShow child attributes
Show child attributes
응답
Request accepted.
The deferred request ID used to poll GET /grok/v1/videos/{request_id}.
curl https://api.cometapi.com/grok/v1/videos/generations \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
--data-binary '{
"model": "grok-imagine-video-1.5",
"prompt": "A paper boat glides across a quiet pond at sunrise.",
"duration": 1,
"aspect_ratio": "16:9",
"resolution": "480p"
}'{
"request_id": "<request_id>"
}