方式一
通过 EvoLink API 接入
适合：产品后端、批量任务、自动化工作流
在你的服务端直接调用 EvoLink 统一视频 API，自己控制模型 ID、参数、任务队列、callback 和结果存储。
- 1在 Playground 用真实 brief 验证效果和成本
- 2在控制台创建 EvoLink API Key
- 3按上方路由卡选择与任务匹配的模型 ID
- 4提交任务，通过轮询或 HTTPS callback 获取结果
Grok Imagine Video 1.5 API
通过 EvoLink 统一视频 API 接入 Grok Imagine Video 1.5（xAI 的 Grok 视频模型）。接入前可先测试文生视频、图生视频、参考生视频与同步生成的音频。
xAI视频生成可用
480p 视频每秒低至 ~$0.056$0.080 官方价格-30%
文生视频图生视频参考生视频画面声音同步生成多分辨率输出
生产路由已上线
模型特点
文生 / 图生 / 参考生三模式 · 画面声音同步生成 · 1–15 秒视频
适用场景
商品展示、人物短视频和影视分镜预演
输入
文本提示词 + 0–7 张 JPEG / PNG / WebP 图片
输出
异步生成 480p / 720p / 1080p 视频
在接入 API 之前，先试试 Grok Imagine Video 1.5 的效果。
填写动作和运镜提示词，按需上传最多 7 张图片，再选择时长与分辨率。提交前可以查看预计消耗，生成完成后可直接预览结果。
生成测试视频
填写 Prompt，按需上传图片，并设置生成参数。Grok Imagine Video 1.5模式随输入自动判型 · from $0.056/s
输入图片
图生视频可选，最多 7 张。0 张 = 文生视频 · 1 张 = 图生视频 · 2-7 张 = 多图参考
1generated-image.png
—
✓ 已添加 1 张图片
https://cdn.evolink.ai/Model-Example/GrokImagine1.5/generated-image.png
1/7 个文件
时长6s
分辨率
宽高比
单张输入图时不生效：输出画幅跟随该图尺寸。
预计消耗：~$0.34323.324 cr
480p × 6s + 1 input image
可以生成
生成记录
生成结果保留 24 小时，需要的请及时下载。
生成记录会显示在这里
充值前，先了解 Grok Imagine Video 1.5 的测试成本。
费用由视频时长、分辨率和输入图片张数决定。输出视频按秒计费，每张输入图片另收一笔固定费用；只写 Prompt 的文生视频不产生图片费用。
第一次测试要花多少？
文生视频 · 1 秒 · 480p预计积分3.808
生成 1 条 1 秒 480p 视频，不带输入图片
预计费用$0.056
$10 额度大约可以测试 178 次
建议先用 480p 调整动作、运镜和构图，效果确认后再切换到 720p 或 1080p，减少无效消耗。
EvoLink 价格 $0.056
官方价格 $0.080 · save 30%
测试预算参考
根据预计测试次数选择充值金额。$10
约可测试 178 次
适合首次验证模型效果。
$50
约可测试 892 次
适合反复调整动作和构图。
$100
约可测试 1785 次
适合正式接入前进行较完整的测试。
常见生成费用
低成本试效果480p · 6s
~$0.343-30%
~23.324 cr·~$0.490 官方价格高清效果确认720p · 6s
~$0.595-30%
~40.46 cr·~$0.850 官方价格较长视频测试1080p · 6s
~$1.057-30%
~71.876 cr·~$1.510 官方价格480p · 15s480p · 15s
~$0.847-30%
~57.596 cr·~$1.210 官方价格以上为单次生成、包含 1 张输入图片的预计总费用。实际费用会随时长、分辨率和上传图片张数变化。
详细价格
Grok Imagine Video 1.5-30% vs official
grok-imagine-video-1.5-preview| 生成方式 | 480p | 720p | 1080p | 计费单位 |
|---|---|---|---|---|
| 视频生成输出视频按秒计费 | $0.056/s-30% 3.808 cr/s$0.080 官方价格 | $0.098/s-30% 6.664 cr/s$0.140 官方价格 | $0.175/s-30% 11.9 cr/s$0.250 官方价格 | 按输出视频秒数计费 |
视频生成
输出视频按秒计费 · 按输出视频秒数计费
480p
$0.056/s-30%
3.808 cr/s$0.080 官方价格720p
$0.098/s-30%
6.664 cr/s$0.140 官方价格1080p
$0.175/s-30%
11.9 cr/s$0.250 官方价格输出视频按秒计费，720p 的费率是 480p 的 1.75 倍，1080p 是 3.125 倍；输入图片按张固定收费，可以是 0 到 7 张。
| 项目 | 计费说明 | 价格 | 积分 |
|---|---|---|---|
| 输入图片 | 每张输入图片（0–7 张，选填） | $0.0070/张-30% $0.010 官方价格 | 0.476 cr |
输入图片为选填项。上传几张就按几张固定收费，与分辨率无关；只写 Prompt 的文生视频不产生图片费用。
Grok Imagine Video 1.5 适合做什么？
Grok Imagine Video 1.5 是 xAI 正式发布的视频模型。在 EvoLink 上，同一个模型 ID 覆盖三种生成方式，具体用哪种由上传的图片张数决定：不传图就是文生视频，传 1 张就把它作为首帧生成图生视频，传 2–7 张则融合成参考生视频。每次请求都需要填写 Prompt，输出 1–15 秒的 480p、720p 或 1080p 短视频。通过 EvoLink 还能在生成前查看预计费用，并与其他模型共用同一个 API Key。
输入
Prompt + 0–7 张图片
输出
短视频
时长
1–15 秒
分辨率
480p / 720p / 1080p（2 张及以上：最高 720p）
宽高比
auto（默认）/ 16:9 / 9:16 / 1:1 / 3:2 / 2:3
Grok Imagine Video 1.5 API 调用的 Model ID
Grok Imagine Video 1.5（preview 别名）
grok-imagine-video-1.5-preview一个 Model ID 覆盖全部三种模式——不传图为文生视频、传 1 张让图动起来、传 2-7 张做参考混合。xAI 上游稳定版 ID 是 grok-imagine-video-1.5，EvoLink 当前按 preview 别名路由。
两种方式接入 Grok Imagine Video 1.5：EvoLink API 或 Agent
需要嵌入产品、运行批量任务时，直接使用 EvoLink API；需要快速创作、试验或让 Agent 完成接入时，可在 Codex、Claude 或 Gemini 中调用。两种方式共用 EvoLink API Key、余额、模型路由和任务记录。
方式二
在 Agent 中调用
适合：Codex、Claude、Gemini 中的创作与开发任务
把输出目标、素材和验收标准交给 Agent，它可以选择路由、组装请求、跟踪任务并返回结果，不需要你手写每一步。
- 1在本地环境变量中设置 EVOLINK_API_KEY，不要写进代码或 Prompt
- 2描述输出目标、参考素材和关键参数
- 3让 Agent 调用 Grok Imagine Video 1.5 路由并保存 task ID
- 4让 Agent 轮询到最终状态、下载结果并报告失败原因
Grok Imagine Video 1.5 最擅长什么
一个模型 ID 覆盖三种生成方式
只写 Prompt 直接生成、用商品图或分镜图作为首帧生成，或者一次融合 2–7 张参考图——都不需要切换模型名或接口。
画面与声音一次生成
生成视频的同时可以加入环境音、动作音效和人物对白。正式发布前仍建议检查声音是否自然、是否与画面同步。
适合接入业务的异步任务流程
提交任务后，可通过轮询或回调获取生成状态；视频完成后请及时下载，或保存到自己的存储服务。
Grok Imagine Video 1.5 适合用来做什么
Grok Imagine Video 1.5 商品展示与广告短片
Grok Imagine Video 1.5 人物口播与社交短视频
Grok Imagine Video 1.5 影视分镜与概念预演
Grok Imagine Video 1.5 API 代码示例与错误处理
示例展示最短可运行流程：创建任务、保存返回的 task ID，然后轮询或等待 HTTPS callback。完整参数与响应字段见 API 标签页。
cURL
curl -X POST https://api.evolink.ai/v1/videos/generations \
-H "Authorization: Bearer $EVOLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video-1.5-preview",
"prompt": "The person starts dancing under stage lights",
"duration": 6,
"quality": "480p",
"aspect_ratio": "16:9",
"callback_url": "https://your-domain.com/webhooks/video-task-completed"
}'
# Save the returned task ID, then query:
curl https://api.evolink.ai/v1/tasks/{task_id} \
-H "Authorization: Bearer $EVOLINK_API_KEY"参数校验失败
对照上方参数卡逐项检查：取值范围、可选枚举、素材数量和文件类型必须与所选路由一致。
鉴权或余额问题
检查 Authorization Bearer Token，并在控制台确认可用余额与任务计费。
内容或素材被拒
检查肖像权、品牌素材、可读文字、敏感内容以及输入素材的合规性。
任务失败或超时
Grok Imagine Video 1.5 任务最终状态为失败时不扣费。保留 task ID，查看最终状态，先判断是校验、审核还是执行环节出错，再决定是否重试。
未收到 callback
callback_url 必须是公网 HTTPS 地址，不能是 localhost 或内网地址。始终保留 task ID 作为轮询兜底。
接入 Grok Imagine Video 1.5 前先确认这些规格与限制
| 规格 | Grok Imagine Video 1.5 | 对接入的影响 | 不适合这些需求 |
|---|---|---|---|
| 生成方式 | 支持文生视频、图生视频和参考生视频 | 图片张数决定生成方式，一次对接即可覆盖三种用法。 | 需要首尾帧控制或视频转视频编辑。 |
| 输入要求 | 0–7 张图片 + 非空提示词 | 提交前必须检查 Prompt，并把图片数量控制在 7 张以内。 | 需要超过 7 张参考图，或需要视频作为输入。 |
| 时长与输出 | 480p、720p 或 1080p，时长 1–15 秒 | 视频越长、分辨率越高，费用越高。 | 需要超过 15 秒的更长视频。 |
| 输出构图 | 默认 auto，也可选 5 种固定比例；单张源图始终优先 | 文生和多图参考可直接指定比例；选 auto 则把画幅交给上游渠道。 | 你需要 4:3、3:4 或支持列表之外的比例。 |
| 任务方式 | 异步生成，支持轮询或回调 | 任务完成后要做好去重，避免重复处理结果。 | 必须立即同步返回生成结果。 |
| 计费 | 按输出秒数计费，另按张收取输入图片费用 | 应在提交前估价，并限制失败重试带来的额外费用。 | 需要与视频时长无关的固定价格。 |
生成方式
Grok Imagine Video 1.5支持文生视频、图生视频和参考生视频
对接入的影响图片张数决定生成方式，一次对接即可覆盖三种用法。
不适合这些需求需要首尾帧控制或视频转视频编辑。
输入要求
Grok Imagine Video 1.50–7 张图片 + 非空提示词
对接入的影响提交前必须检查 Prompt，并把图片数量控制在 7 张以内。
不适合这些需求需要超过 7 张参考图，或需要视频作为输入。
时长与输出
Grok Imagine Video 1.5480p、720p 或 1080p，时长 1–15 秒
对接入的影响视频越长、分辨率越高，费用越高。
不适合这些需求需要超过 15 秒的更长视频。
输出构图
Grok Imagine Video 1.5默认 auto，也可选 5 种固定比例；单张源图始终优先
对接入的影响文生和多图参考可直接指定比例；选 auto 则把画幅交给上游渠道。
不适合这些需求你需要 4:3、3:4 或支持列表之外的比例。
任务方式
Grok Imagine Video 1.5异步生成，支持轮询或回调
对接入的影响任务完成后要做好去重，避免重复处理结果。
不适合这些需求必须立即同步返回生成结果。
计费
Grok Imagine Video 1.5按输出秒数计费，另按张收取输入图片费用
对接入的影响应在提交前估价，并限制失败重试带来的额外费用。
不适合这些需求需要与视频时长无关的固定价格。
调用 Grok Imagine Video 1.5 前需要知道的三件事
Grok Imagine Video 1.5 正式模型与调用 ID 不同
xAI 的正式模型 ID 是 grok-imagine-video-1.5；通过 EvoLink 调用时，请使用示例中显示的 grok-imagine-video-1.5-preview。
Grok Imagine Video 1.5 按图片张数决定生成方式
接口没有 mode 参数。不传 image_urls 就是文生视频；传 1 张 JPEG、PNG 或 WebP（不超过 10 MB）会把它作为首帧生成；传 2–7 张则作为参考图融合。超过 7 张会被拒绝。
Grok Imagine Video 1.5 生成结果需要及时保存
任务提交后可通过轮询或回调获取状态。结果链接只保留 24 小时，请及时下载，或保存到自己的存储服务。
为什么通过 EvoLink 接入 Grok Imagine Video 1.5
生成前查看费用
根据视频时长、分辨率和输入图片张数计算预计消耗，减少无效测试。
一套 API 接入多个模型
使用同一套鉴权和调用方式接入 Grok Imagine 及其他视频模型。
一个账户管理余额
在同一个 EvoLink 账户里查看余额、支出和各模型用量。
统一跟踪任务状态
用一致的异步流程查看等待中、生成中、已完成和失败的任务。
按场景选择合适模型
需要纯提示词、单图或多图参考生成短视频时使用 Grok 1.5，其他输入方式可切换到更匹配的模型。
Grok Imagine 模型家族
在同一个 EvoLink 账户和 API Key 下对比 Grok Imagine 各路由，再按输出质量、时长和成本选择。
Grok Imagine Video 1.5
Grok Imagine Video 1.5 是 xAI 正式发布的视频模型。在 EvoLink 上，同一个模型 ID 覆盖三种生成方式，具体用哪种由上传的图片张数决定：不传图就是文生视频，传 1 张就把它作为首帧生成图生视频，传 2–7 张则融合成参考生视频。每次请求都需要填写 Prompt，输出 1–15 秒的 480p、720p 或 1080p 短视频。通过 EvoLink 还能在生成前查看预计费用，并与其他模型共用同一个 API Key。
查看 API
Grok Imagine Video 1.5 之外的其他视频模型
Grok Imagine Video 1.5 常见问题
什么是 Grok Imagine Video 1.5？
Grok Imagine Video 1.5 是 xAI 正式发布的视频模型。只写 Prompt、上传 1 张图片，或传入 2–7 张参考图，都能生成带同步音频的短视频。
在 EvoLink 上应使用哪个模型 ID？
通过 EvoLink 调用时，请使用 grok-imagine-video-1.5-preview。xAI 的正式模型 ID 是 grok-imagine-video-1.5，不同接入渠道使用的 ID 可能不同。
为什么 EvoLink 模型 ID 中仍包含 preview？
preview 仍是 xAI 保留的兼容别名，也是 EvoLink 当前公开使用的调用 ID。这不代表 xAI 仍将 1.5 归类为预览版。
Grok Imagine Video 1.5 支持文生视频吗？
支持。不传 image_urls 或传入空数组，请求就会按文生视频处理，仅凭 Prompt 生成，并且不产生图片费用。
可以使用多张参考图吗？
可以。在 image_urls 中传入 2–7 张图片，请求会按参考生视频处理，把这些图片融合在一起。超过 7 张会被拒绝。首尾帧模式目前仍不支持。
三种生成方式怎么选？
不需要传 mode 参数。image_urls 中有效图片的张数直接决定：0 张走文生视频，1 张走图生视频（该图作为首帧），2–7 张走参考生视频（多图融合）。
对图片和提示词输入有什么要求？
Prompt 始终必填，最多 2,000 tokens（中文等非拉丁文字每个字符占用的 token 更多）。图片为选填，最多 7 张，需为 JPEG、PNG 或 WebP，单张不超过 10 MB。
Grok Imagine Video 1.5 的费用是多少？
费用由输出时长、分辨率和上传的图片张数共同决定，每张输入图片单独计费。请以页面价格区块和 Playground 的实时估价为准，不要依赖其他页面复制的静态价格。
支持哪些分辨率和时长？
EvoLink 当前支持 480p、720p 和 1080p，时长可选 1–15 秒。输出按秒计费，以 480p 为基准：720p 是 1.75 倍，1080p 是 3.125 倍，与 xAI 官方每秒价格的比例一致。
输出画幅如何确定？
文生视频与多图参考生视频（2-7 张）支持 aspect_ratio 参数：auto（默认）、16:9、9:16、1:1、3:2、2:3。auto 表示由上游渠道决定画幅，不同次生成可能不同——需要稳定画幅请显式指定一个具体比例。只上传 1 张输入图时该参数不生效，输出画幅跟随该图尺寸，请按希望的最终构图准备这张图。
Grok Imagine Video 1.5 会生成音频吗？
可以。模型能在生成视频的同时加入环境音、动作音效和人物对白。不同场景的声音效果可能有差异，正式使用前请检查音画同步和声音自然度。
如何接收生成完成的视频？
生成采用异步任务方式。提交后可以轮询任务状态，也可以提供 HTTPS 回调地址；任务完成后请及时下载视频，或保存到自己的存储服务。
结果 URL 可以使用多长时间？
结果链接的有效期为 24 小时。请及时下载，或转存到自己的对象存储；不要在正式业务中长期引用临时链接。
失败或被审核拦截的请求一定免费吗？
不一定。生成失败或触发内容审核时，请以任务返回的用量信息和账户账单为准；自动重试前应先确认是否已经产生费用。