Skip to content

Happyhorse โ€‹

Updated

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

Happyhorse is a video generation model that supports text-to-video, first-frame video generation, and multi-image reference generation with 1โ€“9 images. 1.0 also accepts a reference video; output ranges from 720P to 4K with durations of 3โ€“15 seconds.

Basic Information โ€‹

ItemValue
ModelNameH2
ModelVersion1.1 / 1.0
Default valueModelVersion=1.1 / Resolution=1080P
Guardrail disable supportSupported

Supported Specifications by Version โ€‹

VersionResolutionAspect ratioLength
1.1720P / 1080P / 2K / 4K16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 4:5 / 5:4 / 9:21 / 21:93~15 seconds, default 5 seconds
1.0720P / 1080P / 2K / 4K16:9 / 9:16 / 1:1 / 3:4 / 4:33~15 seconds, default 5 seconds

Supports multi-image reference and reference video.

Input Conditions โ€‹

Supports text generation, first frame image, and reference image 1~9 images. Video reference is supported in 1.0.

Request Parameters โ€‹

ParameterRequiredTypeDescription
ModelNameRequiredStringFixed value H2
ModelVersionOptionalString1.1 / 1.0
PromptRequiredStringGeneration prompt. Maximum 2000 characters
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.
VideoInfos.NOptionalArrayReference video array. Only works in 1.0
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
ExtraParameters.
EnablelnputComplianceCheck
OptionalBooleanIf false is explicitly passed, input moderation is disabled. Contact your sales representative before use
ExtraParameters.
EnableOutputComplianceCheck
OptionalBooleanIf false is explicitly passed, output moderation is disabled. Contact your sales representative before use

Request Example โ€‹

Reference Generation โ€‹

Reference video generation uses ModelVersion=1.0.

json
{
  "ModelName": "H2",
  "ModelVersion": "1.0",
  "Prompt": "<<<image_1>>> dances in the rain",
  "ImageInfos": [
    {
      "Category": "Image",
      "Url": "https://<cdn>/ref1.png"
    }
  ],
  "Duration": 5,
  "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>"
  }
}

Special Configuration โ€‹

Guardrail Disable โ€‹

Input and output moderation can be configured separately.

To use the guardrail disable parameters, you must first contact your sales representative to confirm usage permission. Even on supported engines, the guardrail is disabled only when the parameter is explicitly passed. If the parameter is omitted, it is not disabled.

ParameterDisable ValueTarget
ExtraParameters.EnablelnputComplianceCheckfalseInput moderation disabled
ExtraParameters.EnableOutputComplianceCheckfalseOutput moderation disabled

Merge the following configuration into an existing generation request. To disable both input and output moderation, pass both fields together.

json
{
  "ExtraParameters": {
    "EnablelnputComplianceCheck": false,
    "EnableOutputComplianceCheck": false
  }
}

Built with VitePress ยท Deployed on Tencent EdgeOne Pages