APIMPAPIMP
User GuideAI APIImage APIVideo APIPublic API

happyhorse-1.1

Submit an async HappyHorse 1.1 video generation task. A single model id happyhorse-1.1; the mode (text-to-video / image-to-video / reference-to-video) is inferred from the image / images fields in the request. Returns a task_id to poll via the status endpoint until status=finished.

POST
/api/generate/submit

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string

固定值 happyhorse-1.1

Value in"happyhorse-1.1"
prompt?string

视频描述,最多 2500 字符。Text-to-Video 必填;带媒体输入(image / images)时可省。

size?string

视频比例,默认 16:9

Value in"16:9" | "9:16" | "1:1" | "4:3" | "3:4"
duration?integer

视频时长,单位为秒。范围 3..15,默认 5。

Range3 <= value <= 15
image?string

单图生视频使用的首帧图片,支持 URL 或 Base64。

images?array<string>

参考图生视频使用的图片列表,最多 9 张。

Itemsitems <= 9
resolution?string

视频清晰度,默认 1080P

Value in"720P" | "1080P"
watermark?boolean

是否给生成视频打上水印,默认 false

seed?integer

随机种子,范围 [0, 2147483647],用于复现。

Range0 <= value <= 2147483647
callback_url?string

任务终态时由平台主动 POST 的 HTTPS 回调地址(可选)。

Formaturi
[key: string]?never

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.apimp.ai/api/generate/submit" \  -H "Content-Type: application/json" \  -d '{    "model": "happyhorse-1.1",    "prompt": "A brown horse galloping across a golden meadow at sunset"  }'
{
  "code": 200,
  "data": {
    "task_id": "task_2BvCWmHzG6sJxK4tQpAr8M9nZyYfRdLs",
    "status": "not_started",
    "created_time": "2026-06-27T09:21:26",
    "error_message": null
  }
}

{
  "code": 400,
  "error": {
    "message": "prompt is required unless `image` (I2V) or `images` (R2V) is provided",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}

How is this guide?

Last updated on