Create a video

POST/v1/videos

Authorization

BeefAPIKeyBearer

AuthorizationBearer <token>

Use Authorization: Bearer sk-...

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

model*"grok-imagine-video-1.5"

Value in

"grok-imagine-video-1.5"

prompt*string

duration?integer

Reference mode is limited to 10 seconds.

Range1 <= value <= 15

Default4

resolution?string

Reference mode is limited to 720p.

Default"480p"

Value in

"480p"
"720p"
"1080p"

aspect_ratio?string

Default"16:9"

Value in

"1:1"
"16:9"
"9:16"
"4:3"
"3:4"
"3:2"
"2:3"

generate_audio?boolean

Explicit false requests silence; omission uses the model default.

image?|

reference_images?array<|>

Do not combine with image.

Itemsitems <= 7

reference_audios?array<>

Preset voices only; activates reference-mode limits.

Itemsitems <= 3

Response Body

`application/json`

curl -X POST "https://example.com/v1/videos" \  -H "Authorization: Bearer YOUR_BEEFAPI_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "grok-imagine-video-1.5",    "prompt": "string"  }'

{  "id": "string",  "object": "string",  "model": "string",  "status": "queued",  "created_at": 0,  "error": {    "code": "string",    "message": "string"  }}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

429application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`