Parameters below were verified against the live model directory on November 5, 2026 . Check the model directory for current schema, availability, and prices.
Text-to-video generation. A text prompt alone drives video generation—no reference materials required—ideal for turning copy and creative descriptions into motion quickly. First-frame image reference. Pass an image via media[].type: first_frame to anchor the opening frame (image-to-video style), while the prompt describes how the scene evolves.
The full model guide, live parameter schema, and playground for every model ID are available in the HiPix model directory .
Model ID Mode Notes aliyun/wan2-2/image-to-video-globalImage-to-Video aliyun/wan2-2/text-to-video-globalText-to-Video aliyun/wan2-6/image-to-video-globalImage-to-Video aliyun/wan2-6/reference-to-video-globalReference-to-Video Currently unavailable on HiPix aliyun/wan2-6/text-to-video-globalText-to-Video aliyun/wan2-7/image-to-videoImage-to-Video aliyun/wan2-7/image-to-video-spImage-to-Video aliyun/wan2-7/text-to-videoText-to-Video aliyun/wan2-7/text-to-video-spText-to-Video
Requests are submitted to POST /v1/videos (video) or POST /v1/images/generations / POST /v1/images/edits (image). Fields marked metadata.* travel inside the metadata object.
API field Type Required Values / limit promptstring Yes — metadata.img_urlarray Yes up to 1; ≤10 MB each; images metadata.resolutionenum Yes 480P, 1080P; default 480P
API field Type Required Values / limit promptstring Yes — sizeenum Yes 1920*1080, 1080*1920, 1440*1440, 1632*1224, 1224*1632, 832*480, 480*832, 624*624; default 624*624
API field Type Required Values / limit promptstring Yes — metadata.img_urlarray Yes up to 1; ≤10 MB each; images metadata.resolutionenum Yes 720P, 1080P; default 720Psecondsnumber Yes 4–15 (integer); default 5
API field Type Required Values / limit promptstring Yes — metadata.reference_urlsarray Yes up to 1; ≤10 MB each; image/,video/ sizeenum Yes 1280*720, 720*1280, 960*960, 1088*832, 832*1088, 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632; default 960*960secondsnumber Yes 4–15 (integer); default 5 metadata.audioboolean No true / false
API field Type Required Values / limit promptstring Yes — sizeenum Yes 1280*720, 720*1280, 960*960, 1088*832, 832*1088, 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632; default 960*960secondsnumber Yes 4–15 (integer); default 5
API field Type Required Values / limit promptstring Yes — metadata.mediaarray Yes ≤10 MB each; images metadata.negative_promptstring No — metadata.resolutionenum Yes 720P, 1080P; default 720Pmetadata.ratioenum Yes 1:1, 9:16, 16:9, 3:4, 4:3; default 1:1secondsnumber Yes 4–15 (integer); default 5
API field Type Required Values / limit promptstring Yes — metadata.negative_promptstring No — metadata.mediaarray Yes up to 1; ≤10 MB each; images metadata.resolutionenum Yes 720P, 1080P; default 720Pmetadata.ratioenum Yes 1:1, 9:16, 16:9, 3:4, 4:3; default 1:1secondsnumber Yes 4–15 (integer); default 5
API field Type Required Values / limit promptstring Yes — metadata.negative_promptstring No — metadata.resolutionenum Yes 720P, 1080P; default 720Pmetadata.ratioenum Yes 1:1, 16:9, 9:16, 4:3, 3:4; default 1:1secondsnumber Yes 4–15 (integer); default 5
A minimal request for aliyun/wan2-7/text-to-video:
curl -X POST https://api.apimart.cc/v1/videos \
-H " Authorization: Bearer $HIPIX_API_KEY " \
-H " Content-Type: application/json " \
-d ' {"model": "aliyun/wan2-7/text-to-video", "prompt": "A kitten running through a sunlit garden", "seconds": 5, "metadata": {"resolution": "720P", "ratio": "1:1"}} '
Poll the task with GET /v1/videos/{task_id} until status is completed or failed.
Submit only the input types listed for the exact model ID; unsupported inputs are rejected or removed on HiPix.
See Submit a Video Task or the model directory for the full request contract, and Pricing & Billing for how charges are settled.
Prices and availability are shown per model ID in the model directory .
