ModelFold Docs

English

简体中文

English

简体中文

Appearance

Hailuo Standard Image to Video ​

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.

Content generation using hailuo/02-image-to-video-standard

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 hailuo/02-image-to-video-standard for this endpoint Default："hailuo/02-image-to-video-standard"。 Allowed values：hailuo/02-image-to-video-standard。 示例：hailuo/02-image-to-video-standard。
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.promptstringYesThe text prompt describing the video to generate (Max length: 1500 characters) 示例：Epic aerial shot: A lone samurai stands atop a jagged mountain peak as a storm of sakura petals is swept across the wind. Behind him, the sky is split in two — half daylight, half night. The shot pulls back to reveal that the mountain is actually the curved back of a sleeping dragon that spans across the horizon. Lightning crackles in the distance as the dragon's eye slowly opens, glowing with ancient magic. The samurai doesn’t flinch; he lowers his straw hat and places his hand on the hilt of his blade.。
  input.image_urlstringYesThe URL of the image to use as the first frame of the video (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB) 示例：https://file.aiquickdraw.com/custom-page/akr/section-images/17585207681646umf3lz8.png。
  input.end_image_urlstringNoOptional URL of the image to use as the last frame of the video (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB) 示例：https://file.aiquickdraw.com/custom-page/akr/section-images/1758521423357w8586uq8.png。
  input.durationstringYesRequired. Video duration in seconds: 6 or 10. Allowed values：6 / 10。 示例：10。
  input.resolutionstringYesRequired. The resolution of the generated video. Allowed values：512P / 768P。 示例：768P。
  input.prompt_optimizerbooleanNoWhether to use the model's prompt optimizer (Boolean value (true/false)) 示例：true。
  input.nsfw_checkerbooleanNoDefaults to false. When false, no additional content filtering is applied and results are returned directly by the model.

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": "hailuo/02-image-to-video-standard",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "Epic aerial shot: A lone samurai stands atop a jagged mountain peak as a storm of sakura petals is swept across the wind. Behind him, the sky is split in two — half daylight, half night. The shot pulls back to reveal that the mountain is actually the curved back of a sleeping dragon that spans across the horizon. Lightning crackles in the distance as the dragon'\''s eye slowly opens, glowing with ancient magic. The samurai doesn’t flinch; he lowers his straw hat and places his hand on the hilt of his blade.",
    "image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/17585207681646umf3lz8.png",
    "end_image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1758521423357w8586uq8.png",
    "duration": "10",
    "resolution": "768P",
    "prompt_optimizer": true
  }
}'
json
{
  "model": "hailuo/02-image-to-video-standard",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "Epic aerial shot: A lone samurai stands atop a jagged mountain peak as a storm of sakura petals is swept across the wind. Behind him, the sky is split in two — half daylight, half night. The shot pulls back to reveal that the mountain is actually the curved back of a sleeping dragon that spans across the horizon. Lightning crackles in the distance as the dragon's eye slowly opens, glowing with ancient magic. The samurai doesn’t flinch; he lowers his straw hat and places his hand on the hilt of his blade.",
    "image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/17585207681646umf3lz8.png",
    "end_image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1758521423357w8586uq8.png",
    "duration": "10",
    "resolution": "768P",
    "prompt_optimizer": true
  }
}

Response ​

200 — Request successful ​

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

Callback ​

videoTaskCompleted ​

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

The system sends this callback when the hailuo/02-image-to-video-standard 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：hailuo/02-image-to-video-standard。 示例：hailuo/02-image-to-video-standard。
  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": "hailuo/02-image-to-video-standard",
    "state": "success",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"Epic aerial shot: A lone samurai stands atop a jagged mountain peak as a storm of sakura petals is swept across the w...\\\",\\\"image_url\\\":\\\"https://example.com/input-image.jpg\\\",\\\"end_image_url\\\":\\\"https://example.com/input-image.jpg\\\",\\\"duration\\\":\\\"10\\\",\\\"resolution\\\":\\\"768P\\\",\\\"prompt_optimizer\\\":true}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"hailuo/02-image-to-video-standard\"}",
    "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": "hailuo/02-image-to-video-standard",
    "state": "fail",
    "param": "{\"input\":\"{\\\"prompt\\\":\\\"Epic aerial shot: A lone samurai stands atop a jagged mountain peak as a storm of sakura petals is swept across the w...\\\",\\\"image_url\\\":\\\"https://example.com/input-image.jpg\\\",\\\"end_image_url\\\":\\\"https://example.com/input-image.jpg\\\",\\\"duration\\\":\\\"10\\\",\\\"resolution\\\":\\\"768P\\\",\\\"prompt_optimizer\\\":true}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"hailuo/02-image-to-video-standard\"}",
    "failCode": "400",
    "failMsg": "<error detail>",
    "costTime": 12,
    "creditsConsumed": 0
  }
}

ModelFold — one API for all the best AI models.

© 2026 ModelFold