---
title: "create reference video"
method: POST
path: "/generation/wanx/happyhorse-1.0/ref2video"
tags: ["generation", "video generation"]
---

# create reference video

`POST /generation/wanx/happyhorse-1.0/ref2video`

## Request body

- object
  - `input` object, required
    - `prompt` string, required — The prompt of the generation
    - `duration` 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15
    - `aspectRatio` '1:1' | '4:3' | '3:4' | '16:9' | '9:16'
    - `resolution` '720P' | '1080P' — The resolution of the generation
    - `seed` number — The seed of the generation
    - `videoNum` number
    - `refs` union[]
      - union
        - object
          - `type` 'image', required
          - `name` string, required
          - `image` string, uri, required
          - `order` number, required
          - `avatarId` string
        - object
          - `type` 'subject', required
          - `name` string, required
          - `images` object[], required
            - `url` string, uri, required
            - `order` number, required
          - `subjectId` string, required
        - object
          - `type` 'video', required
          - `name` string, required
          - `video` string, uri, required
          - `order` number, required
        - object
          - `type` 'audio', required
          - `name` string, required
          - `audio` string, uri, required
          - `order` number, required
    - `imageMeta` object[]
      - `name` string
      - `url` string, required — Original image URL
      - `order` number, required — Image order
      - `cropper` object
        - `url` string, required — Cropped image URL
        - `detail` object, required
          - `x` number, required
          - `y` number, required
          - `width` number, required
          - `height` number, required
          - `rotate` number, required
          - `scaleX` number, required
          - `scaleY` number, required
        - `height` number, required
        - `width` number, required
  - `webhookUrl` string
  - `clientSource` string

## Response `200`

Successful response

- object
  - `taskId` string, required
  - `status` 'waiting' | 'succeed' | 'failed' | 'processing', required

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/pollo/apis/pollo-ai-video-collection.md) · [All operations](https://skmtc.net/pollo/apis/pollo-ai-video-collection/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pollo/pollo-ai-video-collection/revisions/b3c228cf4e87/schema)