BeefAPICreate a video
Start a video generation task, then check its progress.
/v1/videosSend your API key in the Authorization: Bearer YOUR_BEEFAPI_KEY header. Get an API key →
Request example
Use your key. Replace sample task IDs and image URLs.
curl -X POST "https://global.beefapi.com/v1/videos" \ -H "Authorization: Bearer YOUR_BEEFAPI_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "grok-imagine-video-1.5", "prompt": "A paper boat drifting across a sunlit pond. Gentle camera movement.", "duration": 4, "resolution": "480p", "aspect_ratio": "16:9" }'Response examples
Illustrative values. Select a status code.
Task accepted, not a finished video.
{ "id": "video_example", "object": "video", "model": "grok-imagine-video-1.5", "status": "queued", "created_at": 1788825600}Request parameters
application/json
| Parameter | Description |
|---|---|
model | The video model ID to use. Supported value: |
prompt | Describe the scene, motion and camera movement. |
duration | Reference mode is limited to 10 seconds. Default: Minimum: Maximum: |
resolution | Reference mode is limited to 720p. Default: Allowed values: |
aspect_ratio | The width-to-height ratio of the video. Default: Allowed values: |
generate_audio | Explicit false requests silence; omission uses the model default. |
image | The first frame, provided as an image URL or an object containing url. Field detailsThe first frame, provided as an image URL or an object containing url. Public HTTPS URL or data URL. |
reference_images | Do not combine with image. Max. items: Field detailsDo not combine with image. Items items <= 7[index: integer]?| |
reference_audios | Preset voices only; activates reference-mode limits. Max. items: Field detailsPreset voices only; activates reference-mode limits. Items items <= 3[index: integer]? |
Response fields & status codes
Response fields
application/json
application/json
application/json
application/json
application/json
application/json