GRGlobalRouter Docs
Console

Videos / POST

Create video

Creates an OpenAI-compatible video generation task.

Endpoints

Mobile only shows the endpoint list. View parameter details and examples on desktop.

MethodEndpointDescription
POST/v1/videos/generationsCreates an OpenAI-compatible video generation task.
POST/v1/videos/generations

Video generation is asynchronous. After creation, poll /v1/tasks/{task_id} with the returned task ID or receive completion through webhook_url.

Back to Videos endpoint list

Request parameters

FieldTypeRequiredDescription
modelstringYesVideo model ID.
promptstringYesVideo generation prompt.
providerstringNoSpecify provider preferences.
routingobjectNoRouting preference, such as provider or strategy tags.
inputobjectNoTask input extension fields merged into the video task input.
contentobject[]NoMultimodal content parts.
image_urlstringNoReference image URL for image-to-video.
video_urlstringNoReference video URL for continuation or transformation.
audio_urlstringNoReference audio URL.
durationnumberNoVideo duration; ranges depend on model support.
duration_secondsnumberNoVideo duration alias.
resolutionstringNoResolution tier.
ratiostringNoAspect ratio alias.
aspect_ratiostringNoAspect ratio.
seedintegerNoRandom seed.
watermarkbooleanNoWhether to add a watermark.
generate_audiobooleanNoWhether to generate audio as well.
online_searchbooleanNoWhether to enable web search when the model supports it.
return_last_framebooleanNoWhether to return the last frame.
execution_expires_afterintegerNoExecution expiration time; units depend on model support.
safety_identifierstringNoSafety tracking identifier.
skip_asset_registerbooleanNoWhether to skip artifact persistence.
srobjectNoSuper Resolution post-processing configuration.
webhook_urlstringNoCallback URL after task completion or failure.
metadataobjectNoApplication metadata.
priorityintegerNoTask priority from 0 to 10.
idempotency_keystringNoIdempotency key in the request body; the Idempotency-Key header may also be used.
Idempotency-KeyheaderNoIdempotency key to avoid duplicate task creation during client retries.

Response fields

FieldTypeRequiredDescription
idstringYesTask ID.
objectstringYes固定为 task。
statusstringYesStatus such as queued, running, succeeded, or failed.
progressnumberYes任务进度，0 到 1。
progress_detailobjectNo细分进度信息。
typestringYes任务类型，例如 video_generation。
capabilitystringNoTask capability tag.
modelstringYesModel ID used by the task.
inputobjectYes任务输入快照。
outputarrayNoArtifact list after task success.
result.original_artifactsarrayNoOriginal generated artifact saved when SR is enabled.
result.sr_artifactsarrayNoEnhanced artifact after SR.
result.default_artifactsstringNoWhether current output uses original or sr.
resultobjectNoProvider 结果摘要。
errorobjectNoError information on failure.
usageobjectNo用量与计费明细。
attemptobjectYes重试次数摘要，包含 current 和 max。
linksobjectNoQuery, cancellation, or event subscription URL.
metadata.srobjectNoSubtask summary when SR is enabled.
links.selfstringNoTask query URL.
providerstringNo实际执行 Provider。
cost_usdnumberNo任务成本。
billing_model_keystringNo计费models键。
discount_idstringNo折扣 ID。
discount_factornumberYes折扣因子。
list_costnumberYes折前标价成本。
discount_amountnumberYes折扣金额。
actual_costnumberYes实际扣费。
webhook_urlstringNo任务回调 URL。
metadataobjectNoApplication metadata.
priorityintegerYes任务优先级。
started_atstringNo任务开始时间。
finished_atstringNo任务结束时间。
completed_atstringNo任务完成时间。
canceled_atstringNo任务取消时间。
created_atstringYes任务create时间。
updated_atstringYes任务update时间。

Errors

401UNAUTHORIZED

Missing or invalid Authorization Bearer token.

403FORBIDDEN

The current API key is not allowed to call this scope or model.

429RATE_LIMITED

请求过快或异步任务队列已满，请降低并发或稍后重试。