Skip to main content
Matrix 支持 Grok Imagine 系列的图片和视频生成模型,接口兼容 OpenAI 格式,可直接用 curl / OpenAI SDK / 任意 HTTP 客户端调用。

模型清单

实际扣费 = 单价 × 数量(或秒数) × 你所在分组的折扣倍率。具体折扣以控制台为准,本文价格为模型基准价。

图片生成

图片生成为同步调用:提交 prompt 后等待几秒,直接返回图片(URL 或 Base64)。

调用示例

参数说明

Grok 图片模型不支持 size / quality 参数(输出尺寸固定),填了会被忽略。

响应格式

  • data[].url:图片直链(当 response_format=url)
  • data[].b64_json:Base64 编码(当 response_format=b64_json)
返回的图片链接是临时链接,请生成后立即下载保存。

Python 示例(保存图片)

标准版 vs 高清版

两者用法完全一致,只需替换 model 字段。

视频生成

视频生成为异步任务:先提交 prompt 拿到任务 ID,然后轮询直到生成完成(一个 4 秒视频通常 30–60 秒),最后取回视频 URL。

第 1 步:提交任务

参数说明

返回任务信息,记下 task_id:

第 2 步:轮询任务状态

返回的 data.status 状态: 建议每 5–10 秒轮询一次。

第 3 步:获取结果

任务完成(SUCCESS)后的返回:
  • data.result_url:视频下载直链(MP4)。
视频链接同样是临时链接(数小时内有效),请尽快下载保存。

Python 完整示例

视频生成注意事项

  • 耗时:一个 4 秒视频通常 30–60 秒生成,时长越长越慢
  • 成本:0.07/秒。例:40.07/秒。例:4 秒 ≈ 0.28、10 秒 ≈ $0.70(再乘分组折扣)
  • 时长可调:用 seconds 控制,范围 1–15 秒
  • 轮询间隔:建议 5–10 秒,总等待时间留足 5 分钟

常见问题