视频生成 API

实操（填参 / 轮询 / 下载 / 排错）见 视频生成 API 使用指南。

Grok Imagine 视频是异步任务。Host 与 Key 都是本站，不要打到 api.x.ai。

令牌分组必须是 Grok-Main。不要用 /v1/chat/completions 调视频模型。

POST https://api.ashpetals.com/v1/videos
GET  https://api.ashpetals.com/v1/videos/{id}
GET  https://api.ashpetals.com/v1/videos/{id}/content

# 路径别名（同样受理）
POST https://api.ashpetals.com/v1/videos/generations
POST https://api.ashpetals.com/xai/v1/videos/generations

提交成功后，用返回的 id（同时可能带 task_id / request_id）去轮询和下载。

模型

模型 ID	说明
grok-imagine-video	文生视频。480p / 720p
grok-imagine-video-1.5	1.5 文生视频。480p / 720p / 1080p
grok-imagine-video-1.5-preview	1.5 的别名，计费与能力相同

以 GET /v1/models 为准。grok-imagine / grok-imagine-edit 不是视频接口（生图 / 修图走 /v1/images）。

创建任务

curl https://api.ashpetals.com/v1/videos \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "一只橘猫在阳光下的窗台上打盹，镜头缓慢推近",
    "seconds": "4"
  }'

duration 数字或字符串均可；seconds 必须是字符串（如 "4"，数字会 400）。

参数

参数	类型	说明
model	string	必填
prompt	string	必填
duration	number / string	秒数
seconds	string	秒数，必须字符串
aspect_ratio / resolution	string	可透传
image / input_reference	—	不要带。图生视频上游 422/415，失败会退款

响应

HTTP 200 只表示任务已受理。上游可能只回 request_id；本站会把它填进 id。

轮询与下载

curl https://api.ashpetals.com/v1/videos/TASK_ID \
  -H "Authorization: Bearer ***"

curl -o video.mp4 https://api.ashpetals.com/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer ***"

status	含义
queued / pending	排队
in_progress	生成中
completed / done	完成，立刻拉 /content
failed	失败，自动退款

下载用提交时的任务 id，不要用响应里 video.url 的内部路径。

成片地址大约 25 分钟后失效，完成后马上保存到本地。/content 不重复扣费。

计费

按秒预扣：广场 ModelPrice × 秒 × 分组倍率。三个视频 SKU 同价；1.5 的 1080p 不另加价。失败退款。以 分组与价格 和广场为准。

不要这样做

打法	结果
/v1/chat/completions + 视频模型	400
图生视频	422 / 415，退款
令牌不是 Grok-Main	无渠道
完成后不立刻下载	约 25 分钟后 404