Build with Runway
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": "runway",
"input": {
"prompt": "<prompt>",
"duration": "<duration>",
"quality": "<quality>"
}
}'Inputs & settings
promptstringRequiredDescriptive text that guides the AI video generation. Be specific about subject, action, style, and setting. When used with an image, describes how to animate or modify the image content. Maximum length is 1800 characters.
qualitystringRequiredVideo resolution, optional values are 720p or 1080p. If 1080p is selected, 10-second video cannot be generated
durationnumberRequiredVideo duration, optional values are 5 or 10. If 10-second video is selected, 1080p resolution cannot be used
image_urlstringOptional reference image URL to base the video on. When provided, the AI will create a video animating or extending this image.
watermarkstringVideo watermark text content. An empty string indicates no watermark, while a non-empty string will display the specified text as a watermark in the bottom right corner of the video.
aspect_ratiostringVideo aspect ratio parameter. Required parameter for text-to-video generation requests. This parameter is invalid when image_url is passed, and the aspect ratio will ultimately be determined by the provided image.**
Options: 16:9, 4:3, 1:1, 3:4, 9:16
Full input schema
{
"type": "object",
"required": [
"prompt",
"duration",
"quality"
],
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "Descriptive text that guides the AI video generation. Be specific about subject, action, style, and setting. When used with an image, describes how to animate or modify the image content. Maximum length is 1800 characters."
},
"quality": {
"type": "string",
"title": "Quality",
"description": "Video resolution, optional values are 720p or 1080p. If 1080p is selected, 10-second video cannot be generated"
},
"duration": {
"type": "number",
"title": "Duration",
"description": "Video duration, optional values are 5 or 10. If 10-second video is selected, 1080p resolution cannot be used"
},
"image_url": {
"type": "string",
"title": "Image URL",
"format": "uri",
"x-media": "image",
"description": "Optional reference image URL to base the video on. When provided, the AI will create a video animating or extending this image."
},
"watermark": {
"type": "string",
"title": "Watermark",
"description": "Video watermark text content. An empty string indicates no watermark, while a non-empty string will display the specified text as a watermark in the bottom right corner of the video."
},
"aspect_ratio": {
"enum": [
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"type": "string",
"title": "Aspect ratio",
"description": "Video aspect ratio parameter. Required parameter for text-to-video generation requests. This parameter is invalid when image_url is passed, and the aspect ratio will ultimately be determined by the provided image.**"
}
}
}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.
