Skip to main content
POST
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
  • Official-channel Grok Imagine video extend feature
  • Extend the duration of existing videos by 2-10 seconds
  • Async task management, query results via task ID

Path Parameters

string
필수
Original video task IDThis is the task ID returned from a previous video generation request. The finished video of that task is used as the extension source.To extend an arbitrary video URL without a source task, use POST /v1/videos/extend and pass video_urls in the body instead of a path parameter.

Authorizations

string
필수
All API requests require Bearer Token authenticationGet API Key: Visit the API Key Management Page to obtain your API KeyAdd to request headers:

Body

string
기본값:"grok-imagine-video-official"
필수
Video extend model nameExample: "grok-imagine-video-official"
string
필수
Text description for video extension
integer
기본값:"6"
Extension length in secondsSupported range: 2–10 seconds
string[]
Source video URL list. Required when using POST /v1/videos/extend without a task ID; optional when video_id is present in the path.Public http:///https:// URLs or platform asset:// references.
Pricing note: Extension bills the generated extension seconds plus the input source video duration per second. The input video duration is determined automatically by the platform; it does not need to be declared in the request.

Response

string
Unique task identifier for querying task status
string
Object type, always generation.task
string
Model name used
string
Task status
  • queued - Waiting to be processed
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
integer
Task progress percentage (0-100)
integer
Task creation timestamp (Unix timestamp)
object
Task metadata