如何使用 Grok Imagine Video 1.5 Preview API:图生视频接入指南(2026)
Grok Imagine Video 1.5 Preview API 接入教程:参数说明、价格与可直接运行的调用代码,先在 Playground 试玩再一行代码接入。
Grok Imagine Video 1.5 Preview 是一款图生视频模型(由 Grok 提供):Grok 单张首帧图生视频模型。必须提供输入图片,支持 1-15 秒、480p/720p 输出。在 NamiFusion 上可以在 Playground 直接试玩(提交前显示准确报价),再通过统一 REST API 一行代码接入,典型一次调用约 $0.570。
TL;DR
· 任务类型:图生视频,由 Grok 提供
· 价格:典型一次约 $0.570($1 = 100 积分),按量计费无订阅
· 上手路径:Playground 试玩(提交前显示报价)→ API Keys 建密钥 → 一个 POST 接入
· 可调参数:5 个(见下方参数表)
· 无平台水印,商用可用(遵守服务条款)
用 Grok Imagine Video 1.5 Preview 能做什么?
短视频与广告片段:从一句话或一张图直接产出可发布的动态素材。
产品演示与概念预览:低成本验证分镜和视觉方向,再决定是否实拍。
社媒内容工厂:批量生成竖屏短片,配合热点话题快速上线。
已有素材的二次创作:图生视频让静态作品动起来,延长内容生命周期。
怎么调用这个 API?
1. 在 NamiFusion 注册并在 API Keys 页面创建密钥(注册送免费积分)。
2. 用下面的 cURL 示例提交任务,Header 带上 Bearer 密钥。
3. 用返回的 task_uuid 轮询任务状态,完成后取输出 URL。
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/grok-imagine-video-1.5-preview" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"image": "https://assets-public.namifusion.com/uploads/images/2026-04-10/a947fe8cbbe0.png",
"prompt": "A cinematic scene of a futuristic city at night, illuminated by neon lights and flying cars.",
"seconds": "4",
"aspect_ratio": "16:9",
"resolution": "720p"
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"有哪些参数?
image(输入图片):必填
prompt(提示词):必填
seconds(视频时长):可选,默认 "4"
aspect_ratio(画幅比例):可选,默认 "16:9"
resolution(分辨率):可选,默认 "720p"
Grok Imagine Video 1.5 Preview 的提示词怎么写?
1. 主体在前:先写画面主角与动作,再补环境、光线、风格("一名宇航员在雨中的霓虹街头奔跑,电影感,浅景深")。
2. 用具体名词代替形容词堆砌:"85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
3. 迭代时只改一个变量:固定 seed 复现结果,每次只调整一个描述词,才能知道是什么在起作用。
4. 负面信息放正面写:与其说"不要模糊",不如直接要"锐利对焦、清晰细节"。
价格是多少?
按次积分计价,典型一次调用约 $0.570($1 = 100 积分),实际价格随参数(分辨率/时长等)变化,Playground 里提交前会显示准确报价。
Grok Imagine Video 1.5 Preview
单张首帧图生视频模型。只接入 grok-imagine-video-1.5-preview,不支持纯文生视频、多参考图、视频扩展或视频编辑。
请求
POST /api/v1/marketplace/run/grok-imagine-video-1.5-preview
{
"input": {
"image": "https://assets-public.namifusion.com/uploads/images/2026-04-10/a947fe8cbbe0.png",
"prompt": "Animate this image with natural motion and a stable camera. Keep the subject recognizable. No text, no watermark.",
"seconds": "4",
"aspect_ratio": "9:16",
"resolution": "720p"
}
}
参数:
image:必填,公网图片 URL 或 base64 data URL。prompt:必填,描述运动、镜头和要保留的主体特征。seconds:1 到 15 秒,默认 4。aspect_ratio:1:1、16:9、9:16、4:3、3:4、3:2、2:3,默认16:9。resolution:480p或720p,默认720p。
计费
Marketplace 按 credits 计费,1 美元 = 100 credits:
- 480p:8 credits / 秒 + 输入图 1 credit。
- 720p:14 credits / 秒 + 输入图 1 credit。
示例:1 秒 480p = 9 credits;1 秒 720p = 15 credits。
输出
提交后返回任务 UUID。任务完成后 output_results.videos 为生成视频 URL 列表。
FAQ
可以先免费试用吗?+
注册即送积分,但赠送积分目前仅适用于应用内的部分换脸功能;本模型按量积分计费。Playground 仍可无代码试玩,提交前会显示准确报价。
生成内容可以商用吗?有水印吗?+
可以商用,NamiFusion 不给生成结果加平台水印;使用须遵守服务条款与适用法律。
内容政策是什么?+
NamiFusion 是无过滤引擎,不做武断限制、对 NSFW 友好,但禁止违法内容与非自愿的真人素材,详见服务条款。
Grok Imagine Video 1.5 Preview 的任务要跑多久?+
取决于参数,图像通常数秒到数十秒,视频通常数十秒到几分钟;API 返回 task_uuid 供轮询。
分辨率/时长上限是多少?+
以模型参数表为准:每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。