提交生成任务
POST /v1/video/generations 用你的星模 API Key 鉴权，创建视频生成任务并返回任务 job id（响应 id 字段，形如 vidjob_*）。请求体包含 model、prompt 与可选控制项：image_url 作为首帧条件（图生视频）、duration 指定成片秒数、resolution 选择 "480P" | "720P" | "1080P"、aspect_ratio 指定画面比例。提交是异步的——响应只包含任务 ID，不包含视频。
curl
curl -X POST https://modelxing.com/v1/video/generations \
-H "Authorization: Bearer $XMODEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan3.0-video-cn",
"prompt": "夜市上空一盏纸灯笼缓缓漂过，电影感慢摇镜头",
"duration_seconds": 5,
"resolution": "720P",
"aspect_ratio": "16:9"
}'Python
import os
import requests
resp = requests.post(
"https://modelxing.com/v1/video/generations",
headers={
"Authorization": f"Bearer {os.environ['XMODEL_API_KEY']}",
"Content-Type": "application/json",
},
json={
"model": "wan3.0-video-cn",
"prompt": "夜市上空一盏纸灯笼缓缓漂过，电影感慢摇镜头",
"duration_seconds": 5,
"resolution": "720P",
"aspect_ratio": "16:9",
},
)
resp.raise_for_status()
job_id = resp.json()["job_id"]轮询任务并取回 mp4
GET /v1/video/jobs/{job_id} 持续报告任务状态直至终态：queued | running | succeeded | failed。成功时 video.url 返回预签名 mp4 链接；失败时 error 携带原因。生成耗时从数十秒到数分钟不等（取决于模型、时长与分辨率），建议每 5-10 秒轮询一次。video.url 是预签名链接、会过期，成功后请尽快下载或转存文件。
curl
curl https://modelxing.com/v1/video/jobs/{job_id} \
-H "Authorization: Bearer $XMODEL_API_KEY"Python
import os
import time
import requests
headers = {"Authorization": f"Bearer {os.environ['XMODEL_API_KEY']}"}
while True:
task = requests.get(
f"https://modelxing.com/v1/video/jobs/{job_id}",
headers=headers,
).json()
if task["status"] == "succeeded":
print(task["video.url"]) # 预签名 mp4，请尽快下载
break
if task["status"] == "failed":
raise RuntimeError(task.get("error"))
time.sleep(5)| queued | 任务已受理，等待算力 |
| running | 正在生成画面 |
| succeeded | video.url 返回预签名 mp4（链接会过期） |
| failed | error 携带失败原因，修正后重新提交 |
支持的模型
所有视频模型共用上文的请求/响应面——只需更换 model id。计费按生成秒数、分辨率分档（480P / 720P / 1080P）；各模型每秒分档价格见其模型价格页。
| wan3.0-video-cn | Wan 3.0 文生/图生视频，国内服 |
| wan3.0-video-glb | Wan 3.0 文生/图生视频，全球服 |
| wan3.0-video-prime-cn | Wan 3.0 Prime，国内服 |
| wan3.0-video-prime-glb | Wan 3.0 Prime，全球服 |