Magi 1 24b
Playground
Try it on WavespeedAI!MAGI-1 is a video generation model with exceptional understanding of physical interactions and cinematic prompts.
Features
MAGI-1
MAGI-1 is a video generation model with exceptional understanding of physical interactions and cinematic prompts.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/magi-1-24b" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"prompt": "In front of the pyramid under the setting sun, an African queen slowly walked out of the temple. She wore golden armor and her eyes were firm. The wind brought dust and cape. She slowly walked towards the throne. The background music was solemn and magnificent, as if it heralded the awakening and revival of a kingdom.",
"image": "https://d3gnftk2yhz9lr.wavespeed.ai/media/images/1745552832830322655_jemjfbyu.jpg",
"num_frames": 96,
"frames_per_second": 24,
"resolution": "720p",
"enable_safety_checker": true,
"aspect_ratio": "auto"
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | The text prompt to guide video generation. | |
| image | string | No | - | URL of an input image to represent the first frame of the video. If the input image does not match the chosen aspect ratio, it is resized and center cropped. | |
| num_frames | integer | No | 96 | 96 ~ 192 | Number of frames to generate. Must be between 81 to 100 (inclusive). If the number of frames is greater than 81, the video will be generated with 1.25x more billing units. |
| frames_per_second | integer | No | 24 | 5 ~ 30 | Frames per second of the generated video. Must be between 5 to 30. |
| seed | integer | No | - | -1 ~ 2147483647 | The random seed to use for the generation. |
| resolution | string | No | 720p | - | Resolution of the generated video (480p or 720p). 480p is 0.5 billing units, and 720p is 1 billing unit. |
| enable_safety_checker | boolean | No | true | - | If set to true, the safety checker will be enabled. |
| aspect_ratio | string | No | auto | - | Aspect ratio of the generated video. If 'auto', the aspect ratio will be determined automatically based on the input image. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Query Parameters
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |