APIMart 上的 Grok Imagine API 视频接口调用 xAI 的 grok-imagine-video 模型:文生视频、用一张或多张参考图做图生视频,以及编辑已有视频。输出 1–15 秒、480p 或 720p,按输出秒数计费。
服务亮点
根据提示词生成视频,也可以添加参考图片来引导生成结果。
提交前审核提示词和输入图片;命中违规内容时不会创建任务或扣费。
视频链接有效期为 72 小时,请及时下载或转存。
透明定价,无隐藏费用。按量付费,用多少付多少。
| 型号 | 规格 | 黄金价当前价格 | 铂金价 | 钻石价 | 官方价 | 为你节省 |
|---|---|---|---|---|---|---|
grok-imagine-video | 参考图片(每张) | 0.016Credits(~$0.0016)/张 | 0.0152Credits(~$0.0015)/张 | 0.0144Credits(~$0.0014)/张 | 0.02Credits(~$0.002)/张 | 20% |
| 参考视频(按源视频时长) | 0.08Credits(~$0.008)/秒 | 0.076Credits(~$0.0076)/秒 | 0.072Credits(~$0.0072)/秒 | 0.1Credits(~$0.01)/秒 | 20% | |
| 480P | 0.4Credits(~$0.04)/秒 | 0.38Credits(~$0.038)/秒 | 0.36Credits(~$0.036)/秒 | 0.5Credits(~$0.05)/秒 | 20% | |
| 720P | 0.56Credits(~$0.056)/秒 | 0.532Credits(~$0.0532)/秒 | 0.504Credits(~$0.0504)/秒 | 0.7Credits(~$0.07)/秒 | 20% |
* 实际费用以最终输出为准。
一个接口、三种模式:只发提示词即文生视频,加上 image_urls 让静态图动起来,传 video.url 则编辑你已有的视频。需要 1080p 请看 Grok Imagine Video 1.5 专页;本页对应基础版 grok-imagine-video,也是唯一支持视频编辑的型号。
50K+
活跃用户
99.9%
在线率
2x
更快
—
成本节省
在 APIMart 上用一个 POST 请求调用 Grok Imagine Video API。生成为异步任务:先提交任务,再轮询任务接口获取视频地址。
把上面创建的 Key 保存到环境变量 APIMART_API_KEY,并在每个请求中以 Authorization: Bearer <key> 发送。
向 POST /v1/videos/generations 发送 model grok-imagine-video、提示词、duration、resolution 和 aspect_ratio。图生视频加 image_urls;编辑视频则只传 video.url。任务 ID 在 data[0].task_id。
轮询 GET /v1/tasks/{task_id},状态为 completed 后从 data.result.videos[0].url[0] 读取视频地址,并在 expires_at 前保存。任务失败时原因在 data.error.message,且不扣费。
全部字段、返回结构与错误码见 Grok Imagine Video API 文档。
curl -X POST https://api.apimart.ai/v1/videos/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video",
"prompt": "暖色晨光透过窗户洒在木桌上,镜头缓慢推近一只冒着热气的陶瓷咖啡杯,浅景深",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "grok-imagine-video",
"prompt": "暖色晨光透过窗户洒在木桌上,镜头缓慢推近一只冒着热气的陶瓷咖啡杯,浅景深",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}
resp = requests.post(f"{API_BASE}/v1/videos/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["videos"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(10)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/videos/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video",
"prompt": "照片中的女子转向镜头微笑,微风吹动她的头发,镜头缓慢推近,柔和日光",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"image_urls": [
"https://example.com/portrait.jpg"
]
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 是 | 默认值: grok-imagine-video | grok-imagine-video。需要 1080p 输出时用 grok-imagine-video-1.5;视频编辑只支持 grok-imagine-video。 |
prompt | string | 是 | 默认值: — | 视频描述或编辑指令,去除首尾空格后 1–8000 个字符。 |
duration | integer | 否 | 默认值: 8 | 输出时长,1–15 的整数秒。仅用于生成。 |
resolution | string | 否 | 默认值: 480p | 480p 或 720p。仅用于生成。 |
aspect_ratio | string | 否 | 默认值: 16:9 | 16:9、9:16、1:1、4:3、3:4、3:2 或 2:3。仅用于生成。 |
image_urls | array | 否 | 默认值: — | Grok 图生视频的公网 HTTPS 图片地址,保留顺序,每张单独计费。文生视频请省略该字段,不要发送空数组。 |
video.url | string | 否 | 默认值: — | 视频编辑用的源视频公网 HTTPS 地址。编辑请求只发送 model、prompt、video 和可选的 nsfw_check。 |
nsfw_check | boolean | 否 | 默认值: false | 设为 true 时,在提交任务前审核提示词和输入图片。 |
grok-imagine-video 接收哪些参数、返回什么,均以 APIMart 接口文档为准
文生视频、图生视频与视频编辑的典型用法
从注册到生成第一个 Grok 视频只需三步
使用邮箱、Google 或 GitHub 注册,之后可随时为团队创建组织。
为账户充值后,余额可用于平台上的所有模型,包括 Grok Imagine Video。
在控制台创建密钥,并在每次请求的 Authorization 请求头中使用。
来自全球创作者和开发者使用 Grok Imagine 视频的真实反馈。以下为 Grok Imagine Video 系列的使用反馈。
“Grok Imagine 视频的简洁性非常出色——只需一个提示词就能得到可用的视频输出,很适合快速原型制作。”
Alex Morgan
创意总监
“APIMart 上的 Grok Imagine 视频改变了我们的内容生产流程。同样的团队现在能产出多得多的视频内容。”
Sarah Kim
市场经理
“作为基于 API 的解决方案,视频质量令人印象深刻。Grok Imagine 视频的文本到视频引擎生成的运动连贯性和视觉保真度非常出色。”
James Wilson
全栈开发者
“我们在不到一天内就将 API 集成到了我们的 SaaS 平台。极简的 API 接口让集成变得非常简单。”
Lisa Chen
CTO, StartupAI
“作为独立电影人,这个 API 彻底改变了我创作概念可视化和分镜动画的方式。”
Marco Rivera
独立电影制作人
“APIMart 基础设施稳定可靠,加上 Grok 的视频质量,已经成为我们做短视频的默认选择。”
Emily Zhang
DevOps 工程师
grok-imagine-video 的调用、计费与型号选择
它是 APIMart 提供的 xAI grok-imagine-video 模型接入,也就是 Grok Imagine API 的视频部分。同一个接口支持文生视频、参考图生成视频(图生视频)和已有视频编辑,输出 1–15 秒、480p 或 720p 的视频。
两者使用同一个接口,提示词上限、1–15 秒时长和参考图能力相同。grok-imagine-video 输出 480p 或 720p,并且是唯一能编辑已有视频的型号;grok-imagine-video-1.5 增加 1080p 输出,但不支持视频编辑,在 APIMart 有单独的页面。两者价格按型号和分辨率不同,以各自页面价格表为准。
带上 API Key 向 POST /v1/videos/generations 发送 model grok-imagine-video 和 prompt,从响应的 data[0].task_id 取得任务 ID。轮询 GET /v1/tasks/{task_id},状态为 completed 后从 data.result.videos[0].url[0] 读取视频。本页的 cURL 与 Python 示例就是这个流程,完整文档见 docs.apimart.ai。
model 和 prompt 必填,prompt 最长 8000 字符。生成时可加 duration(1–15 秒,默认 8)、resolution(480p 或 720p,默认 480p)、aspect_ratio(16:9、9:16、1:1、4:3、3:4、3:2、2:3,默认 16:9)和 image_urls;编辑时改传 video.url。两种模式都可选 nsfw_check。
在 image_urls 中传入一张或多张公网 HTTPS 图片,同时写好提示词。一张图时模型让这张图动起来;多张图时可在提示词里说明每张图的作用,例如第一张是主体、第二张是风格。文生视频请整个省略 image_urls,不要发送空数组。
可以,但只有 grok-imagine-video 支持。发送 model、prompt 和 video.url(公网 HTTPS 视频地址),需要审核时再加 nsfw_check。不要发送 duration、resolution、aspect_ratio 或 image_urls,平台会自动识别源视频时长。grok-imagine-video-1.5 不支持编辑。
按输出视频秒数和所选分辨率计费,每张参考图另收少量费用;视频编辑按源视频秒数计费。按 2026 年 10 月的黄金会员价计算:8 秒 480p 视频 8 × $0.04 = $0.32;10 秒 720p 图生视频加 1 张参考图 10 × $0.056 + $0.0016 = $0.5616;编辑 6 秒视频 6 × ($0.056 + $0.008) = $0.384。本页价格表始终显示当前价格,最终扣费以任务完成后的 cost 字段为准。
生成是异步的,耗时取决于时长、分辨率和排队情况,没有固定秒数。建议每隔几秒查询一次任务;进程重启后可用保存的任务 ID 继续轮询。结果链接会过期,请在 expires_at 之前下载或转存。
按主体、动作、运镜、光线的顺序描述,例如:暖色晨光中,镜头缓慢推近一只冒着热气的陶瓷杯。图生视频时描述你想要的动作,不必重复图里已有的内容。先用 480p 短片试方向,满意后再用 720p 出片。
任务失败时 status 为 failed,原因在 data.error.message,费用为 0。HTTP 429 表示请求过快,请按 Retry-After 等待或退避后重试。网络中断导致提交结果不确定时,用相同的 Idempotency-Key 和相同请求体重发,可避免重复扣费。
不是。xAI Grok Imagine Video API 在 APIMart 上没有免费额度,按量付费、按生成视频的秒数计费,失败任务不扣费,所有价格均享 8 折(立省 20%)。
有。本页价格表展示的是黄金会员价(8 折,立省 20%);铂金、钻石会员更省,最高立省 28%。只为成功的请求付费。
注册 APIMart,在控制台的 API Keys 页面创建密钥即可。同一个 Key 可调用 Grok Imagine Video API 及平台上的所有模型,按量付费、无需订阅。请把 Key 保存在服务端,不要写进前端代码。
Grok Imagine 是 xAI 对其图片与视频生成能力的称呼,grok-imagine-video 是本页调用的 xAI 视频模型。你也可能看到 Grok Imagine AI、GrokImagine,或把图生视频模式称为 Grok I2V。grok-imagine-image 等 Grok 图片模型是另外的型号,有各自的页面。
探索同类型的其他模型。

Wan 3.0 Video
Wan 3.0 is Alibaba's all-in-one video model for text-to-video, first-frame, first-and-last-frame and multimodal reference generation. It accepts image, video, audio and document references and outputs 2–30 second videos at 480P, 720P or 1080P.

Seedance 2.5
Seedance 2.5 is ByteDance's audio-video model for text-to-video, multimodal reference, editing, extension and first-last-frame control. Generate up to 30 seconds in one job with up to 30 images, 10 videos and 10 audio clips as references, at up to 1080p.

Flux 3 Video
FLUX 3 Video by Black Forest Labs supports text-to-video, image-to-video with ordered keyframes and video continuation. It generates 5–20 second HD or FHD clips with synchronized audio in seven aspect ratios.

MiniMax H3
MiniMax H3 is MiniMax's video model for text-to-video, image-to-video with first and last frames, and multimodal reference-to-video using images, videos and audio. It outputs 4–15 second clips at 2K or 768P with an audio track.