Using Runway in your workflow

Sorceress brings Runway models into a shared API catalog. Select this model explicitly, check its supported inputs, and keep your API key on your server. Model capabilities differ; the schema and options on this page describe this entry rather than every model from the same brand.

Explore motion and scene concepts.
Automate video generation with a saved job that your application can track.

Pricing and availability

Sorceress pricing is awaiting activation. The reference catalog lists 12 credits per video; that reference is not a Sorceress quote. This entry cannot currently be invoked through Sorceress.

Inputs and supported options

{
  "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.**"
    }
  }
}

Completion, results and billing

Save the job identifier returned by asynchronous requests and poll the jobs endpoint until the job succeeds or fails. Do not resubmit a generation just because it is still processing. Chat returns a completed reply and usage details. A multi-step workflow can include separately billed successful steps even if a later step fails. Keep returned asset links with your project, and consult each action for its output format.

Coding agents can discover the current catalog and input requirements from the Sorceress agent instructions. Use a Sorceress key; provider credentials stay on the server.