Build with MiniMax H3
Make your first request
Use your Sorceress API key on your server. The playground uses your signed-in account; your application uses the same model with an API key.
curl -X POST 'https://sorceress.games/api/v1/jobs' \
-H 'Authorization: Bearer $SORCERESS_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "minimax-h3-reference-to-video",
"input": {
"duration": 6,
"resolution": "2K",
"aspect_ratio": "adaptive",
"prompt": "<prompt>"
}
}'Inputs & settings
promptstringRequiredVideo generation prompt, length is between 1 and 7000 characters.
durationintegerRequiredThe duration of the generated video, supporting integer values from 4 to 15 seconds.
Options: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
resolutionstringVideo resolution.
Options: 768P, 2K
aspect_ratiostringVideo aspect ratio. The default is adaptive, or a specific ratio can be specified.
Options: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
reference_audio_urlsarrayArray of reference audio URLs. Supports up to 3 audios. Supports WAV, MP3; a single file size cannot exceed 15 MB; the duration of a single segment is 2 to 15 seconds, and the total duration of all reference audios cannot exceed 15 seconds. reference_audio cannot be used alone, it must be accompanied by reference_image or reference_video.
reference_image_urlsarrayArray of reference image URLs. Supports up to 9 images. Publicly accessible HTTP(S) URL; supported image formats include JPG, JPEG, PNG, WEBP, HEIC, and HEIF; a single image size cannot exceed 30 MB; the side length of the image must be between 256 and 5760 pixels, and the aspect ratio must be between 0.4 and 2.5. Provide at least one of reference_image_urls or reference_video_urls.
reference_video_urlsarrayArray of reference video URLs. Supports up to 3 videos. Supports MP4, MOV; video encoding supports H.264, H.265; a single file size cannot exceed 50 MB; the duration of a single segment is 2 to 15 seconds, and the total duration of all reference videos cannot exceed 15 seconds; the video side length must be between 256 and 5760 pixels, the aspect ratio must be between 0.4 and 2.5, and the frame rate must be between 23.976 and 60. Provide at least one of reference_image_urls or reference_video_urls.
Full input schema
{
"type": "object",
"required": [
"prompt",
"duration"
],
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"maxLength": 7000,
"minLength": 1,
"description": "Video generation prompt, length is between 1 and 7000 characters."
},
"duration": {
"enum": [
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"type": "integer",
"title": "Duration",
"default": 6,
"maximum": 15,
"minimum": 4,
"description": "The duration of the generated video, supporting integer values from 4 to 15 seconds."
},
"resolution": {
"enum": [
"768P",
"2K"
],
"type": "string",
"title": "Resolution",
"default": "2K",
"description": "Video resolution."
},
"aspect_ratio": {
"enum": [
"adaptive",
"21:9",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"type": "string",
"title": "Aspect ratio",
"default": "adaptive",
"description": "Video aspect ratio. The default is adaptive, or a specific ratio can be specified."
},
"reference_audio_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"title": "Reference audio URLs",
"x-media": "audio",
"maxItems": 3,
"description": "Array of reference audio URLs. Supports up to 3 audios. Supports WAV, MP3; a single file size cannot exceed 15 MB; the duration of a single segment is 2 to 15 seconds, and the total duration of all reference audios cannot exceed 15 seconds. reference_audio cannot be used alone, it must be accompanied by reference_image or reference_video."
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"title": "Reference image URLs",
"x-media": "image",
"maxItems": 9,
"description": "Array of reference image URLs. Supports up to 9 images. Publicly accessible HTTP(S) URL; supported image formats include JPG, JPEG, PNG, WEBP, HEIC, and HEIF; a single image size cannot exceed 30 MB; the side length of the image must be between 256 and 5760 pixels, and the aspect ratio must be between 0.4 and 2.5. Provide at least one of reference_image_urls or reference_video_urls."
},
"reference_video_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"title": "Reference video URLs",
"x-media": "video",
"maxItems": 3,
"description": "Array of reference video URLs. Supports up to 3 videos. Supports MP4, MOV; video encoding supports H.264, H.265; a single file size cannot exceed 50 MB; the duration of a single segment is 2 to 15 seconds, and the total duration of all reference videos cannot exceed 15 seconds; the video side length must be between 256 and 5760 pixels, the aspect ratio must be between 0.4 and 2.5, and the frame rate must be between 23.976 and 60. Provide at least one of reference_image_urls or reference_video_urls."
}
}
}Results, saved runs & billing
Media requests return a job ID. Poll GET /api/v1/jobs/:id until it succeeds or fails; keep the same ID while it is processing. Long chat requests can also return a saved job to poll. Completed outputs are stored in your account, and successful work is billed using your model's current rates.
A multi-step workflow may include separately billed successful actions. If a connection drops, check your saved run before submitting it again.
