Skip to content

Hy โ€‹

Updated

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask

Hy Video is Tencent Hunyuan's video generation model, supporting text-to-video and image-to-video, and it can take both a first frame and a last frame. It works as a general-purpose base generation engine.

Basic Information โ€‹

ItemValue
ModelNameHunyuan
ModelVersion1.5
Guardrail disable supportNot supported

This is the default engine that supports text-to-video and image-to-video. The first frame and last frame can be specified together.

Request Parameters โ€‹

ParameterRequiredTypeDescription
ModelNameRequiredStringFixed value Hunyuan
ModelVersionOptionalString1.5
PromptRequiredStringGeneration prompt. In text input mode, write up to a maximum of 2000 characters
NegativePromptOptionalStringElements to exclude from the result. Applied on supported models
EnhancePromptOptionalBooleanAutomatic prompt correction. Default value false
ImageUrlOptionalStringFirst frame image URL. Must be externally accessible and 10MB or less
LastImageUrlOptionalStringLast frame image URL. Used together with ImageUrl
ImageInfos.NOptionalArrayReference image array. Category / Url / ReferenceType, etc.
DurationOptionalIntegerGeneration length (seconds). Only allowed values per model are applied
ExtraParametersOptionalObjectResolution / AspectRatio / EnableAudio
AdditionalParametersOptionalStringJSON string containing model-specific options. For the seed delivery format, see Additional configuration reference

Request Example โ€‹

image-to-video (first / last frame) โ€‹

json
{
  "ModelName": "Hunyuan",
  "ModelVersion": "1.5",
  "Prompt": "move the picture",
  "NegativePrompt": "top lighting, oversaturated colors",
  "EnhancePrompt": false,
  "ImageUrl": "https://<cdn>/first.png",
  "LastImageUrl": "https://<cdn>/last.png",
  "Duration": 5,
  "ExtraParameters": {
    "Resolution": "720P",
    "AspectRatio": "16:9",
    "EnableAudio": true
  },
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  }
}

Response Example โ€‹

json
{
  "Response": {
    "Status": "DONE",
    "Message": "ok",
    "Resolution": "1920x1080",
    "VideoUrls": [
      "https://aigc-output-video-<id>.cos.<region>.myqcloud.com/<file>.mp4?q-sign-algorithm=sha1&..."
    ],
    "RequestId": "<request-id>"
  }
}

Built with VitePress ยท Deployed on Tencent EdgeOne Pages