ModelFold Docs

English

简体中文

English

简体中文

Appearance

HappyHorse - video-edit ​

This page is generated from the upstream official OpenAPI documentation. Endpoints, parameters and examples match the official docs; brand and API domain are replaced with ModelFold.

Endpoint ​

POST /jobs/createTask

Full URL: https://ai.modelfold.online/v1/jobs/createTask

Authentication: every request must include the Authorization: Bearer <API_KEY> header.

Overview ​

The output has the same duration as the input video and is rendered at the selected resolution.

TIP

Billed on input video duration + output duration; the output is as long as the input video. For current prices, see ai.modelfold.online/pricing.

Query Task Status ​

After submitting a task, use the unified query endpoint to check progress and retrieve results:

  • Get Task Details — Learn how to query task status and retrieve generation results

TIP

For production use, we recommend using the callBackUrl parameter to receive automatic notifications when generation completes, rather than polling the status endpoint.

Request Parameters ​

Body (application/json) ​

ParameterTypeRequiredDescription
modelstringYesThe model name to use for generation. Required field.
- Must be happyhorse/video-edit for this endpoint Default："happyhorse/video-edit"。 Allowed values：happyhorse/video-edit。 示例：happyhorse/video-edit。
callBackUrlstringNoThe URL to receive generation task completion updates. Optional but recommended for production use.
- System will POST task status and results to this URL when generation completes
- Callback includes generated content URLs and task information
- Your callback endpoint should accept POST requests with JSON payload containing results
- Alternatively, use the Get Task Details endpoint to poll task status
- To ensure callback security, see Webhook Verification Guide for signature verification implementation 示例：https://your-domain.com/api/callback。
inputobjectYesInput parameters for the generation task
  input.promptstringYesRequired edit instruction describing the intended change (e.g., style transfer / local replacement). Up to 5,000 characters. 示例：Make the horse-headed humanoid character in the video wear the striped sweater from the image。
  input.video_urlstringYesURL of the input video (one video).
Video requirements:
Format: MP4, MOV (H.264 encoding recommended).
Duration: 3–60 seconds.
Resolution: the longer side must not exceed 2,160 px; the shorter side must be at least 320 px.
Aspect ratio: 1:2.5–2.5:1.
File size: up to 100 MB.
Frame rate: greater than 8 fps.
  input.reference_imagearray&lt;string&gt;NoOptional reference image URL list (0–5).
Image requirements:
Format: JPEG, JPG, PNG, WEBP.
Resolution: both width and height must be at least 300 px.
Aspect ratio: 1:2.5–2.5:1.
File size: up to 10 MB.
  input.resolutionstringNoOutput video resolution: 720p or 1080p (default). Default："1080p"。 Allowed values：720p / 1080p。 示例：1080p。
  input.audio_settingstringNoAudio handling: auto lets the model handle audio; origin keeps the input video's original audio where possible. Default："auto"。 Allowed values：auto / origin。 示例：auto。
  input.seedintegerNoRandom seed for reproducibility. Default：0。 示例：0。

Request Example ​

bash
curl -X POST "https://ai.modelfold.online/v1/jobs/createTask" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "happyhorse/video-edit",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "Make the horse-headed humanoid character in the video wear the striped sweater from the image",
    "video_url": "https://example.com/your-video.mp4",
    "reference_image": [
      "https://example.com/your-image.png",
      "https://example.com/your-image.png",
      "https://example.com/your-image.png",
      "https://example.com/your-image.png",
      "https://example.com/your-image.png"
    ],
    "resolution": "1080p",
    "audio_setting": "auto",
    "seed": 1764574909
  }
}'
json
{
  "model": "happyhorse/video-edit",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "Make the horse-headed humanoid character in the video wear the striped sweater from the image",
    "video_url": "https://example.com/your-video.mp4",
    "reference_image": [
      "https://example.com/your-image.png",
      "https://example.com/your-image.png",
      "https://example.com/your-image.png",
      "https://example.com/your-image.png",
      "https://example.com/your-image.png"
    ],
    "resolution": "1080p",
    "audio_setting": "auto",
    "seed": 1764574909
  }
}

Response ​

200 — Request successful ​

json
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_bytedance_1765186743319"
  }
}

Callback ​

videoTaskCompleted ​

Callback URL: {request.body#/callBackUrl} (the callBackUrl in the request body).

The system sends this callback when the happyhorse/video-edit task succeeds or fails.

Callback body parameters

参数类型必填说明
codeinteger是Unified callback code: 200 for success, 501 for failure. Allowed values：200 / 501。 示例：200。
msgstring是Unified callback message. Allowed values：Playground task completed successfully. / Playground task failed.。 示例：Playground task completed successfully.。
dataobject是—
  data.taskIdstring是The unique task identifier.
  data.modelstring是The model used for the task. Allowed values：happyhorse/video-edit。 示例：happyhorse/video-edit。
  data.statestring是Terminal task state. Allowed values：success / fail。 示例：success。
  data.paramstring是JSON string containing the submitted task parameters.
  data.resultJsonstring否JSON string containing resultUrls, firstFrameUrl, lastFrameUrl, or resultObject when successful. Present only when state is success.
  data.failCodestring否Failure code, a numeric string such as "400" or "500". Present only when state is fail.
  data.failMsgstring否Failure reason. Present only when state is fail.
  data.costTimeinteger否Processing time in seconds. Present on both success and failure callbacks.
  data.completeTimeinteger否Task completion timestamp.
  data.createTimeinteger否Task creation timestamp.
  data.updateTimeinteger否Use completeTime as the completion time; updateTime may equal createTime.
  data.creditsConsumednumber否Credits consumed by the task; 0 for failed tasks.

Task completed successfully

json
{
  "code": 200,
  "msg": "Playground task completed successfully.",
  "data": {
    "taskId": "task_example_video_webhook_001",
    "model": "happyhorse/video-edit",
    "state": "success",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"Make the horse-headed humanoid character in the video wear the striped sweater from the image\\\",\\\"video_url\\\":\\\"https://example.com/input-video.mp4\\\",\\\"reference_image\\\":[\\\"https://example.com/input-image.jpg\\\"],\\\"resolution\\\":\\\"1080p\\\",\\\"audio_setting\\\":\\\"auto\\\",\\\"seed\\\":1764574909}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"happyhorse/video-edit\"}",
    "resultJson": "{\"resultUrls\":[\"https://example.com/generated-video.mp4\"]}",
    "costTime": 12,
    "completeTime": 1234567890,
    "createTime": 1234560000,
    "updateTime": 1234567890,
    "creditsConsumed": 1.23
  }
}

Task failed

json
{
  "code": 501,
  "msg": "Playground task failed.",
  "data": {
    "taskId": "task_example_video_webhook_001",
    "model": "happyhorse/video-edit",
    "state": "fail",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"Make the horse-headed humanoid character in the video wear the striped sweater from the image\\\",\\\"video_url\\\":\\\"https://example.com/input-video.mp4\\\",\\\"reference_image\\\":[\\\"https://example.com/input-image.jpg\\\"],\\\"resolution\\\":\\\"1080p\\\",\\\"audio_setting\\\":\\\"auto\\\",\\\"seed\\\":1764574909}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"happyhorse/video-edit\"}",
    "failCode": "400",
    "failMsg": "<error detail>",
    "costTime": 12,
    "creditsConsumed": 0
  }
}

ModelFold — one API for all the best AI models.

© 2026 ModelFold