Skip to content

Happyhorse โ€‹

Updated

Endpoint: POST https://vod.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

Specifications Supported 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

Input Conditions โ€‹

Text generation, a first-frame image, and 1~9 reference images are supported. Video reference is supported by 1.0.

Request Parameters โ€‹

ParameterRequiredTypeDescription
ModelNameRequiredStringFixed value H2
ModelVersionOptionalString1.1 / 1.0
PromptRequiredStringGeneration prompt
FileInfos.NOptionalArrayReference input. Usage is FirstFrame (first frame) or Reference (reference)
OutputConfig.ResolutionOptionalString720P / 1080P / 2K / 4K
OutputConfig.DurationOptionalIntegerVideo length (seconds)
OutputConfig.AspectRatioOptionalString16:9 / 9:16 / 1:1, etc.
OutputConfig.
InputComplianceCheck
OptionalStringPassing Disabled explicitly disables input moderation. Contact your sales representative before use
OutputConfig.
OutputComplianceCheck
OptionalStringPassing Disabled explicitly disables output moderation. Contact your sales representative before use

Request Example โ€‹

json
{
  "SubAppId": 123456789,
  "ModelName": "H2",
  "ModelVersion": "1.1",
  "Prompt": "a calm sunset over the ocean, cinematic",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

Response Example โ€‹

json
{
  "AigcVideoTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcVideoGenFile.mp4",
          "ExpireTime": "2026-08-01T10:29:48Z",
          "MetaData": {
            "Width": 1920,
            "Height": 1080,
            "Duration": 5.07,
            "Container": "mov,mp4,m4a",
            "Bitrate": 9494850
          }
        }
      ]
    }
  }
}

Special Settings โ€‹

Guardrail Disable โ€‹

Input and output moderation can be configured separately.

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

ParameterDisable valueApplies to
OutputConfig.InputComplianceCheckDisabledInput moderation disabled
OutputConfig.OutputComplianceCheckDisabledOutput moderation disabled

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

json
{
  "OutputConfig": {
    "InputComplianceCheck": "Disabled",
    "OutputComplianceCheck": "Disabled"
  }
}

Built with VitePress ยท Deployed on Tencent EdgeOne Pages