Videos / POST

Create video

Create an OpenRouter-compatible asynchronous video generation job.

Endpoints

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

MethodEndpointDescription

POST/api/v1/videosCreate an OpenRouter-compatible asynchronous video generation job.

POST/api/v1/videos/super-resolution通过公网视频链接和目标分辨率create异步视频超分任务。

GET/api/v1/videos/{jobId}Read an OpenRouter-compatible video generation job.

GET/api/v1/videos/{jobId}/contentDownload generated video content as raw bytes.

GET/api/v1/videos/modelsList authenticated OpenRouter-compatible video models.

POST/api/v1/videos

Returns 202 Accepted with a public video generation response. Unknown body fields such as routing, metadata, webhook_url, priority, or idempotency fields are rejected.

Back to Videos endpoint list

Request parameters

FieldTypeRequiredDescription

modelstringyesVideo model ID, for example dreamina-seedance-2-0-260128.

promptstringyesText prompt for the video generation.

aspect_ratiostringnoSupported aspect ratio such as 16:9, 9:16, or 1:1. Do not send with size.

callback_urlstringnoHTTPS URI for completion notifications, max 1000 characters.

durationintegernoRequested video length in seconds, >= 1.

frame_imagesobject[]noFirst-frame or last-frame image inputs.

frame_images[].typestringyesMust be image_url for each frame image item.

frame_images[].image_url.urlstringyesRemote image URL for the first or last frame.

frame_images[].frame_typestringyesFrame placement, either first_frame or last_frame.

generate_audiobooleannoWhether audio should be generated when supported.

input_referencesobject[]noReference image, audio, or video inputs.

input_references[].typestringyesReference kind: image_url, audio_url, or video_url.

input_references[].image_url.urlstringconditionalRemote image URL when type is image_url.

input_references[].audio_url.urlstringconditionalRemote audio URL when type is audio_url.

input_references[].video_url.urlstringconditionalRemote video URL when type is video_url.

provider.provider_idstringnoProvider ID used to route the request, for example byteplus.

provider.optionsobjectnoProvider-keyed options, for example { byteplus: { ... } }.

resolutionstringnoSupported resolution such as 480p, 720p, or 1080p. Do not send with size.

srobjectnoVideo super resolution configuration. Only this endpoint supports SR, and only sr.resolution is accepted.

sr.resolutionstringnoTarget SR resolution: 720p, 1080p (default), 1440p, 2160p, or 4k. The service preserves the original aspect ratio and maps this value to the LAS target width.

seedintegernoDeterministic seed when supported by the model.

sizestringnoAllowed values: 480x480, 480x640, 480x720, 480x854, 480x1120, 640x480, 720x480, 720x720, 720x960, 720x1080, 720x1280, 720x1680, 854x480, 960x720, 1080x720, 1080x1080, 1080x1440, 1080x1620, 1080x1920, 1080x2520, 1120x480, 1280x720, 1440x1080, 1620x1080, 1680x720, 1920x1080, 2160x2160, 2160x2880, 2160x3240, 2160x3840, 2160x5040, 2520x1080, 2880x2160, 3240x2160, 3840x2160, 5040x2160. Use either size or resolution/aspect_ratio, not both.

Response fields

FieldTypeRequiredDescription

idstringyesGlobalRouter video generation job ID.

polling_urlstringyesRelative URL for polling the job.

statusstringyespending, in_progress, completed, failed, cancelled, or expired.

errorstringnoFailure message when available.

generation_idstringnoUpstream provider generation ID when available.

unsigned_urlsstring[]noGlobalRouter artifact URLs for completed jobs.

usageobjectnoUsage summary with cost and optional BYOK status.

usage.video_generation_cost_cnynumbernoCNY cost for the original video generation when SR is requested.

usage.sr_cost_cnynumbernoCNY cost for video super resolution when SR is requested.

Notes

Use callback_url for completion notifications. Download completed artifacts from GET /api/v1/videos/{jobId}/content.
Request examples use provider as a string; provider object is reserved for advanced provider-specific options.
Example scenarios: text-to-video, image-first-frame, reference-material.
Use either size or resolution/aspect_ratio, not both.
Inside sr, only resolution is accepted. provider, mode, and other extra properties are rejected.
With SR, the response exposes one final video: the enhanced video on success or the original video when SR fails.

POST/api/v1/videos

curl "https://api.globalrouter.com/api/v1/videos" \
  -H "Authorization: Bearer $GR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-260128",
    "prompt": "全程使用视频1的第一视角构图，全程使用Audio1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款",
    "provider": "byteplus",
    "duration": 11,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "sr": { "resolution": "1080p" },
    "input_references": [
      {
        "type": "image_url",
        "image_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg" }
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg" }
      },
      {
        "type": "video_url",
        "video_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4" }
      },
      {
        "type": "audio_url",
        "audio_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3" }
      }
    ]
  }'

POST/api/v1/videos

curl "https://api.globalrouter.com/api/v1/videos" \
  -H "Authorization: Bearer $GR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "dreamina-seedance-2-0-260128",
  "prompt": "全程使用视频1的第一视角构图，全程使用Audio1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款",
  "provider": "byteplus",
  "duration": 11,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
      }
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
      }
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
      }
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
      }
    }
  ]
}'

POST/api/v1/videos

curl "https://api.globalrouter.com/api/v1/videos" \
  -H "Authorization: Bearer $GR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "dreamina-seedance-2-0-fast-260128",
  "prompt": "写实风格，晴朗的蓝天之下，一大片白色雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上。",
  "provider": "byteplus",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": false
}'

POST/api/v1/videos

curl "https://api.globalrouter.com/api/v1/videos" \
  -H "Authorization: Bearer $GR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "dreamina-seedance-2-0-mini-260615",
  "prompt": "一段轻量级社媒短视频：清晨咖啡杯旁的蒸汽缓慢升起，镜头平稳推进。",
  "provider": "byteplus",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "9:16",
  "generate_audio": false
}'

POST/api/v1/videos

curl "https://api.globalrouter.com/api/v1/videos" \
  -H "Authorization: Bearer $GR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-1-5-pro-251215",
  "prompt": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动，可以听到风声。",
  "provider": "byteplus",
  "duration": 5,
  "resolution": "1080p",
  "aspect_ratio": "adaptive",
  "generate_audio": true,
  "frame_images": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
      },
      "frame_type": "first_frame"
    }
  ]
}'

POST/api/v1/videos

curl "https://api.globalrouter.com/api/v1/videos" \
  -H "Authorization: Bearer $GR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-1-0-pro-250528",
  "prompt": "360度环绕运镜。",
  "provider": "byteplus",
  "duration": 5,
  "resolution": "1080p",
  "aspect_ratio": "adaptive",
  "generate_audio": false,
  "frame_images": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
      },
      "frame_type": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
      },
      "frame_type": "last_frame"
    }
  ]
}'

POST/api/v1/videos

curl "https://api.globalrouter.com/api/v1/videos" \
  -H "Authorization: Bearer $GR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-1-0-pro-fast-251015",
  "prompt": "让画面中的女孩抱着狐狸，镜头缓慢拉出，头发被风吹动。",
  "provider": "byteplus",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "adaptive",
  "generate_audio": false,
  "frame_images": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
      },
      "frame_type": "first_frame"
    }
  ]
}'

200 Response

{
  "id": "job_123",
  "polling_url": "/api/v1/videos/job_123",
  "status": "pending",
  "generation_id": "cgt_123"
}