grok-imagine-video-1.5-preview 인터페이스
Grok
Grok Imagine 1.5 이미지-비디오 변환 Preview
- Grok Imagine 1.5 (grok-imagine-video-1.5-preview) 모델은 이미지-투-비디오 모드를 지원하며, 참조 이미지를 반드시 제공해야 합니다
- 비동기 처리 모드, 반환된 작업 ID를 사용하여 조회
- 생성된 비디오 링크는 24시간 동안 유효하며, 즉시 저장하세요
POST
grok-imagine-video-1.5-preview 인터페이스
인증
본문
application/json
모델 이름
사용 가능한 옵션:
grok-imagine-video-1.5-preview 예시:
"grok-imagine-video-1.5-preview"
비디오 설명 프롬프트 (필수, 비어 있을 수 없음)
길이 제한: 최대 4096 문자
예시:
"The person starts dancing"
참조 이미지 URL (본 모델은 이미지-투-비디오이므로 필수)
요구사항:
1개의 이미지만 지원- 이미지 크기: 최대
10MB - 지원 형식: JPEG, PNG, WebP
Required array length:
1 element예시:
비디오 길이 (초), 1~15초 사이의 임의 정수
필수 범위:
1 <= x <= 15예시:
6
화면 비율
옵션:
16:9: 가로 (기본값)9:16: 세로1:1: 정사각형4:3: 가로 4:33:4: 세로 3:43:2: 가로 3:22:3: 세로 2:3
사용 가능한 옵션:
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 예시:
"16:9"
비디오 해상도, 기본값은 480p
설명:
480p: 표준 해상도, 기본값720p: 고해상도
사용 가능한 옵션:
480p, 720p 예시:
"480p"
작업 완료 후 HTTPS 콜백 URL
콜백 시점:
- 작업이 완료, 실패 또는 취소될 때 트리거됩니다
- 과금 확인 후 전송됩니다
보안 제한:
- HTTPS 프로토콜만 지원
- 내부 IP로의 콜백 금지 (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x 등)
- URL 길이는
2048자를 초과할 수 없습니다
콜백 메커니즘:
- 타임아웃:
10초 - 실패 시 최대
3회 재시도 (1/2/4초 후) - 응답 형식은 작업 조회 API와 동일
- 2xx 상태 코드 = 성공, 그 외는 재시도 트리거
예시:
"https://your-domain.com/webhooks/video-task-completed"
응답
비디오 작업이 성공적으로 생성되었습니다
작업 생성 타임스탬프
예시:
1757169743
작업 ID
예시:
"task-unified-1757169743-7cvnl5zw"
실제 사용된 모델 이름
예시:
"grok-imagine-video-1.5-preview"
특정 작업 유형
사용 가능한 옵션:
video.generation.task 작업 진행률 (0-100)
필수 범위:
0 <= x <= 100예시:
0
작업 상태
사용 가능한 옵션:
pending, processing, completed, failed 예시:
"pending"
비디오 작업 상세 정보
작업 출력 유형
사용 가능한 옵션:
text, image, audio, video 예시:
"video"
사용량 및 과금 정보