HappyHorse-1.1-I2V is an Alibaba model that starts a video scene from an existing image. The image becomes the first frame, while text can specify what happens next: a character's movement, changes in the scene and the camera's direction. It is suited to animating an illustration, a product photograph or a prepared visual concept.
A text prompt is optional. Without one, the model infers possible motion from the initial image. When a prompt is supplied, the source image determines the composition and the appearance of objects, while the words guide how the scene develops over time.
Alibaba highlights preservation of character appearance, visual consistency, smooth movement and the combination of visuals with audio. Its stated aims also include stable text and textures. These properties describe the model's intended capabilities; they do not mean that every pixel is literally preserved in every generated frame.
This mode uses one initial image. It defines the starting scene rather than providing a set of independent references for a new composition. The ability to specify a separate final frame is not stated for this particular version.
JPEG, JPG, PNG and WEBP are accepted. Each dimension of the input image must be at least 300 pixels; the permitted aspect ratio ranges from 1:2.5 to 2.5:1, and the file size limit is 20 MB. The output video's aspect ratio follows the first frame.
The duration is selected as an integer from 3 to 15 seconds. Available resolution levels are 480P, 720P and 1080P; the output format is MP4 at 24 frames per second. Audio can be generated alongside the video.
The prompt may be in any language and contain up to 5000 non-Chinese or 2500 Chinese characters. Any excess is truncated, so important actions and motion details should fit within that limit. The same random seed may produce similar videos, but does not guarantee a frame-by-frame match.
", "aboutText": "HappyHorse-1.1-I2V is an Alibaba model that starts a video scene from an existing image. The image becomes the first frame, while text can specify what happens next: a character's movement, changes in the scene and the camera's direction. It is suited to animating an illustration, a product photograph or a prepared visual concept.\n\nA text prompt is optional. Without one, the model infers possible motion from the initial image. When a prompt is supplied, the source image determines the composition and the appearance of objects, while the words guide how the scene develops over time.\n\n### From the first frame to motion\n\nAlibaba highlights preservation of character appearance, visual consistency, smooth movement and the combination of visuals with audio. Its stated aims also include stable text and textures. These properties describe the model's intended capabilities; they do not mean that every pixel is literally preserved in every generated frame.\n\nThis mode uses one initial image. It defines the starting scene rather than providing a set of independent references for a new composition. The ability to specify a separate final frame is not stated for this particular version.\n\nJPEG, JPG, PNG and WEBP are accepted. Each dimension of the input image must be at least 300 pixels; the permitted aspect ratio ranges from 1:2.5 to 2.5:1, and the file size limit is 20 MB. The output video's aspect ratio follows the first frame.\n\n### Video parameters\n\nThe duration is selected as an integer from 3 to 15 seconds. Available resolution levels are 480P, 720P and 1080P; the output format is MP4 at 24 frames per second. Audio can be generated alongside the video.\n\nThe prompt may be in any language and contain up to 5000 non-Chinese or 2500 Chinese characters. Any excess is truncated, so important actions and motion details should fit within that limit. The same random seed may produce similar videos, but does not guarantee a frame-by-frame match.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "e8adfb803b3334d29d211f59bef2c75e1e048e132d8d72df89864caa44cc334f", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "en", "methods": [ { "html": "happyhorse-1.1-i2vAn image-to-video model: the source image provides the first frame, and the prompt guides the subsequent motion. Creates a short video with optional accompanying audio.
This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.
HappyHorse-1.1-I2V is an Alibaba model that starts a video scene from an existing image. The image becomes the first frame, while text can specify what happens next: a character's movement, changes in the scene and the camera's direction. It is suited to animating an illustration, a product photograph or a prepared visual concept.
A text prompt is optional. Without one, the model infers possible motion from the initial image. When a prompt is supplied, the source image determines the composition and the appearance of objects, while the words guide how the scene develops over time.
Alibaba highlights preservation of character appearance, visual consistency, smooth movement and the combination of visuals with audio. Its stated aims also include stable text and textures. These properties describe the model's intended capabilities; they do not mean that every pixel is literally preserved in every generated frame.
This mode uses one initial image. It defines the starting scene rather than providing a set of independent references for a new composition. The ability to specify a separate final frame is not stated for this particular version.
JPEG, JPG, PNG and WEBP are accepted. Each dimension of the input image must be at least 300 pixels; the permitted aspect ratio ranges from 1:2.5 to 2.5:1, and the file size limit is 20 MB. The output video's aspect ratio follows the first frame.
The duration is selected as an integer from 3 to 15 seconds. Available resolution levels are 480P, 720P and 1080P; the output format is MP4 at 24 frames per second. Audio can be generated alongside the video.
The prompt may be in any language and contain up to 5000 non-Chinese or 2500 Chinese characters. Any excess is truncated, so important actions and motion details should fit within that limit. The same random seed may produce similar videos, but does not guarantee a frame-by-frame match.
POST /v1/videos/generationstext, imagevideo| Field | Type | Requirement | Values & limits | Default |
|---|---|---|---|---|
Fieldmodel | Typestring | RequirementRequired | Values & limits happyhorse-1.1-i2v | Default— |
Fieldprompt | Typestring | RequirementOptional | Values & limits Minimum length: 1 | Default— |
Fieldduration | Typeinteger | RequirementOptional | Values & limits Minimum: 3 Maximum: 15 Unit: seconds | Default5 |
Fieldresolution | Typestring | RequirementOptional | Values & limits 480P, 720P, 1080P | Default720P |
Fieldratio | Typestring | RequirementNot supported | Values & limits | Default— |
Fieldimage_urls | Typehttps_url|data_image_url[] | RequirementRequired | Values & limits Minimum items: 1 Maximum items: 1 Maximum decoded bytes: 20,971,520 MIME types: image/jpeg, image/png, image/webp | Default— |
first_frame_to_video · Required: image_urls
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, image_urls |
Parametermaterial_types | Contracttext, image |
Parameteroptional | Contractduration, resolution, ratio, prompt |
Parameterduration_integer_range | Contract3, 15 |
Parameterdefault_duration | Contract5 |
Parameterresolution | Contract480P, 720P, 1080P |
Parameterdefault_resolution | Contract720P |
Parameterratio | Contract |
Parameterratio_must_omit | Contracttrue |
Parameterimage_urls | Contract{"min_count":1,"max_count":1,"schemes":["https","data raster base64"],"max_data_image_bytes":20971520} |
Lifecycle: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Method shapes and IDs are exact; supplier capability is separate from admission.
POST /v1/videos/generationsAiloot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. How reservation and settlement work →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nSave every completed video or returned file; retrieve every actual returned asset URL.
Preserve every returned data item/output index. content_url is first only; fetch every actual content path/asset. GETcontentwithoutindex isnotalloutputs.
Read existing original job; never resubmit unknown send.
| Field | Type |
|---|---|
Fieldid | Typestring |
Fieldobject | Typestring |
Fieldmodel | Typestring |
Fieldstatus | Typestring |
Fieldcontent_url | Typesigned URL |
Fielddata[] | Typesigned URL |
Fieldusage | Typeobject |
Fieldresult_pending_check | Typeboolean |
| Response | Condition | Next step |
|---|---|---|
Response400 · invalid_request_error | ConditionInvalid required fields, material representation or parameter value | Next stepCorrect the indicated fields before a new creation request. |
Response409 · video_not_ready | ConditionOriginal result content is not yet available | Next stepPoll the original returned ID and respect Retry-After. |
Responseserver_error | ConditionThe returned response says the operation or result requires a check | Next stepKeep the original returned operation/task ID, request headers and response; continue supported reads of that original operation. Do not resubmit the creation request. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Use the method paths shown above.
happyhorse-i2vAn image-to-video model: the source image provides the first frame, and the prompt guides the subsequent motion. Creates a short video with optional accompanying audio.
This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.
HappyHorse-1.1-I2V is an Alibaba model that starts a video scene from an existing image. The image becomes the first frame, while text can specify what happens next: a character's movement, changes in the scene and the camera's direction. It is suited to animating an illustration, a product photograph or a prepared visual concept.
A text prompt is optional. Without one, the model infers possible motion from the initial image. When a prompt is supplied, the source image determines the composition and the appearance of objects, while the words guide how the scene develops over time.
Alibaba highlights preservation of character appearance, visual consistency, smooth movement and the combination of visuals with audio. Its stated aims also include stable text and textures. These properties describe the model's intended capabilities; they do not mean that every pixel is literally preserved in every generated frame.
This mode uses one initial image. It defines the starting scene rather than providing a set of independent references for a new composition. The ability to specify a separate final frame is not stated for this particular version.
JPEG, JPG, PNG and WEBP are accepted. Each dimension of the input image must be at least 300 pixels; the permitted aspect ratio ranges from 1:2.5 to 2.5:1, and the file size limit is 20 MB. The output video's aspect ratio follows the first frame.
The duration is selected as an integer from 3 to 15 seconds. Available resolution levels are 480P, 720P and 1080P; the output format is MP4 at 24 frames per second. Audio can be generated alongside the video.
The prompt may be in any language and contain up to 5000 non-Chinese or 2500 Chinese characters. Any excess is truncated, so important actions and motion details should fit within that limit. The same random seed may produce similar videos, but does not guarantee a frame-by-frame match.
POST /v1/videos/generationstext, imagevideo| Field | Type | Requirement | Values & limits | Default |
|---|---|---|---|---|
Fieldmodel | Typestring | RequirementRequired | Values & limits happyhorse-i2v | Default— |
Fieldprompt | Typestring | RequirementOptional | Values & limits Minimum length: 1 | Default— |
Fieldduration | Typeinteger | RequirementOptional | Values & limits Minimum: 3 Maximum: 15 Unit: seconds | Default5 |
Fieldresolution | Typestring | RequirementOptional | Values & limits 480P, 720P, 1080P | Default720P |
Fieldratio | Typestring | RequirementNot supported | Values & limits | Default— |
Fieldimage_urls | Typehttps_url|data_image_url[] | RequirementRequired | Values & limits Minimum items: 1 Maximum items: 1 Maximum decoded bytes: 20,971,520 MIME types: image/jpeg, image/png, image/webp | Default— |
first_frame_to_video · Required: image_urls
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext, image |
Parameterrequired | Contractnull |
Parameteroptional_controls | Contractnull |
Lifecycle: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Method shapes and IDs are exact; supplier capability is separate from admission.
POST /v1/videos/generationsAiloot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. How reservation and settlement work →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nSave every completed video or returned file; retrieve every actual returned asset URL.
Preserve every returned data item/output index. content_url is first only; fetch every actual content path/asset. GETcontentwithoutindex isnotalloutputs.
Read existing original job; never resubmit unknown send.
| Field | Type |
|---|---|
Fieldid | Typestring |
Fieldobject | Typestring |
Fieldmodel | Typestring |
Fieldstatus | Typestring |
Fieldcontent_url | Typesigned URL |
Fielddata[] | Typesigned URL |
Fieldusage | Typeobject |
Fieldresult_pending_check | Typeboolean |
| Response | Condition | Next step |
|---|---|---|
Response400 · invalid_request_error | ConditionInvalid required fields, material representation or parameter value | Next stepCorrect the indicated fields before a new creation request. |
Response409 · video_not_ready | ConditionOriginal result content is not yet available | Next stepPoll the original returned ID and respect Retry-After. |
Responseserver_error | ConditionThe returned response says the operation or result requires a check | Next stepKeep the original returned operation/task ID, request headers and response; continue supported reads of that original operation. Do not resubmit the creation request. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Use the method paths shown above.
happyhorse-i2v-latestAn image-to-video model: the source image provides the first frame, and the prompt guides the subsequent motion. Creates a short video with optional accompanying audio.
This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.
HappyHorse-1.1-I2V is an Alibaba model that starts a video scene from an existing image. The image becomes the first frame, while text can specify what happens next: a character's movement, changes in the scene and the camera's direction. It is suited to animating an illustration, a product photograph or a prepared visual concept.
A text prompt is optional. Without one, the model infers possible motion from the initial image. When a prompt is supplied, the source image determines the composition and the appearance of objects, while the words guide how the scene develops over time.
Alibaba highlights preservation of character appearance, visual consistency, smooth movement and the combination of visuals with audio. Its stated aims also include stable text and textures. These properties describe the model's intended capabilities; they do not mean that every pixel is literally preserved in every generated frame.
This mode uses one initial image. It defines the starting scene rather than providing a set of independent references for a new composition. The ability to specify a separate final frame is not stated for this particular version.
JPEG, JPG, PNG and WEBP are accepted. Each dimension of the input image must be at least 300 pixels; the permitted aspect ratio ranges from 1:2.5 to 2.5:1, and the file size limit is 20 MB. The output video's aspect ratio follows the first frame.
The duration is selected as an integer from 3 to 15 seconds. Available resolution levels are 480P, 720P and 1080P; the output format is MP4 at 24 frames per second. Audio can be generated alongside the video.
The prompt may be in any language and contain up to 5000 non-Chinese or 2500 Chinese characters. Any excess is truncated, so important actions and motion details should fit within that limit. The same random seed may produce similar videos, but does not guarantee a frame-by-frame match.
POST /v1/videos/generationstext, imagevideo| Field | Type | Requirement | Values & limits | Default |
|---|---|---|---|---|
Fieldmodel | Typestring | RequirementRequired | Values & limits happyhorse-i2v-latest | Default— |
Fieldprompt | Typestring | RequirementOptional | Values & limits Minimum length: 1 | Default— |
Fieldduration | Typeinteger | RequirementOptional | Values & limits Minimum: 3 Maximum: 15 Unit: seconds | Default5 |
Fieldresolution | Typestring | RequirementOptional | Values & limits 480P, 720P, 1080P | Default720P |
Fieldratio | Typestring | RequirementNot supported | Values & limits | Default— |
Fieldimage_urls | Typehttps_url|data_image_url[] | RequirementRequired | Values & limits Minimum items: 1 Maximum items: 1 Maximum decoded bytes: 20,971,520 MIME types: image/jpeg, image/png, image/webp | Default— |
first_frame_to_video · Required: image_urls
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext, image |
Parameterrequired | Contractnull |
Parameteroptional_controls | Contractnull |
Lifecycle: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Method shapes and IDs are exact; supplier capability is separate from admission.
POST /v1/videos/generationsAiloot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. How reservation and settlement work →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v-latest", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nSave every completed video or returned file; retrieve every actual returned asset URL.
Preserve every returned data item/output index. content_url is first only; fetch every actual content path/asset. GETcontentwithoutindex isnotalloutputs.
Read existing original job; never resubmit unknown send.
| Field | Type |
|---|---|
Fieldid | Typestring |
Fieldobject | Typestring |
Fieldmodel | Typestring |
Fieldstatus | Typestring |
Fieldcontent_url | Typesigned URL |
Fielddata[] | Typesigned URL |
Fieldusage | Typeobject |
Fieldresult_pending_check | Typeboolean |
| Response | Condition | Next step |
|---|---|---|
Response400 · invalid_request_error | ConditionInvalid required fields, material representation or parameter value | Next stepCorrect the indicated fields before a new creation request. |
Response409 · video_not_ready | ConditionOriginal result content is not yet available | Next stepPoll the original returned ID and respect Retry-After. |
Responseserver_error | ConditionThe returned response says the operation or result requires a check | Next stepKeep the original returned operation/task ID, request headers and response; continue supported reads of that original operation. Do not resubmit the creation request. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Use the method paths shown above.