Using HappyHorse 1.1 Reference To Video in your workflow

Sorceress brings Alibaba 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 22.5 credits per second 720p, 29 1080p; that reference is not a Sorceress quote. This entry cannot currently be invoked through Sorceress.

Inputs and supported options

{
  "type": "object",
  "required": [
    "prompt",
    "reference_image"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "maxLength": 5000,
      "description": "A description of the desired elements and visual style for the generated video. Input in any language is supported. Up to 5,000 characters. Use \"[Image 1]\", \"[Image 2]\" to refer to the images in reference_image, in the same order. When using a reference, specify the object in the image, such as \"the woman in a red qipao in [Image 1]\"."
    },
    "duration": {
      "type": "number",
      "title": "Duration",
      "default": 5,
      "maximum": 15,
      "minimum": 3,
      "description": "The duration of the generated video, in seconds. Value range: An integer from 3 to 15."
    },
    "resolution": {
      "enum": [
        "720p",
        "1080p"
      ],
      "type": "string",
      "title": "Resolution",
      "default": "1080p",
      "description": "The resolution tier of the generated video. Options: 720p; 1080p"
    },
    "aspect_ratio": {
      "enum": [
        "16:9",
        "9:16",
        "3:4",
        "4:3",
        "4:5",
        "5:4",
        "1:1",
        "9:21",
        "21:9"
      ],
      "type": "string",
      "title": "Aspect ratio",
      "default": "16:9",
      "description": "The aspect ratio of the generated video. Options: 16:9; 9:16; 3:4; 4:3; 4:5; 5:4; 1:1; 9:21; 21:9"
    },
    "reference_image": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "title": "Reference image",
      "x-media": "image",
      "maxItems": 9,
      "description": "The URL of a reference image. Image requirements: 1. Formats: JPEG, JPG, PNG, WEBP. 2. Resolution: The shortest side must be at least 400 pixels. A clear image with a resolution of 720P or higher is recommended. Avoid using images that are too small, blurry, or overly compressed, as this can degrade the output quality. 3. Maximum file size: 20 MB."
    }
  }
}

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.