Matrix 支持 Grok Imagine 系列的图片和视频生成模型,接口兼容 OpenAI 格式,可直接用 curl / OpenAI SDK / 任意 HTTP 客户端调用。
模型清单 模型 类型 接口 同步/异步 计费 grok-imagine-image文生图 / 图生图(标准) /v1/images/generations同步 $0.02 / 张 grok-imagine-image-quality文生图 / 图生图(高清) /v1/images/generations同步 $0.05 / 张 grok-imagine-video文生视频 /v1/video/generations异步 (需轮询)$0.07 / 秒
实际扣费 = 单价 × 数量(或秒数) × 你所在分组的折扣倍率 。具体折扣以控制台为准,本文价格为模型基准价。
图片生成 图片生成为同步调用 :提交 prompt 后等待几秒,直接返回图片(URL 或 Base64)。
调用示例 curl https://matrix.000328.xyz/v1/images/generations \ -H "Authorization: Bearer sk-你的Token" \ -H "Content-Type: application/json" \ -d '{ "model": "grok-imagine-image", "prompt": "A red apple on a white table", "n": 1, "response_format": "url" }'
参数说明 参数 类型 必填 默认 说明 modelstring 是 — grok-imagine-image(标准)或 grok-imagine-image-quality(高清)promptstring 是 — 图片描述,英文效果最佳 。可写画面、光线、风格、镜头等,越具体越好 nint 否 1 一次生成几张。每张单独计费 (n=4 即扣 4 张的钱) response_formatstring 否 urlurl(返回图片链接,推荐)或 b64_json(返回 Base64,适合直接嵌入保存)
Grok 图片模型不支持 size / quality 参数(输出尺寸固定),填了会被忽略。
响应格式 { "created" : 1781854966 , "data" : [ { "url" : "https://imgen.x.ai/xai-imgen/xai-tmp-imgen-xxxx.jpeg" } ], "usage" : { "cost_in_usd_ticks" : 200000000 } }
data[].url:图片直链(当 response_format=url)data[].b64_json:Base64 编码(当 response_format=b64_json)
Python 示例(保存图片) from openai import OpenAI client = OpenAI( api_key = "sk-你的Token" , base_url = "https://matrix.000328.xyz/v1" ) result = client.images.generate( model = "grok-imagine-image" , prompt = "A red apple on a white table" , n = 1 , response_format = "url" ) print ( "图片地址:" , result.data[ 0 ].url)
标准版 vs 高清版 模型 价格 适用 grok-imagine-image$0.02/张 一般需求,便宜,批量出图 grok-imagine-image-quality$0.05/张 需要更精细的图片(海报、封面、产品图、设计素材)
两者用法完全一致,只需替换 model 字段。
视频生成 视频生成为异步任务 :先提交 prompt 拿到任务 ID,然后轮询直到生成完成(一个 4 秒视频通常 30–60 秒),最后取回视频 URL。
第 1 步:提交任务 curl -X POST https://matrix.000328.xyz/v1/video/generations \ -H "Authorization: Bearer sk-你的Token" \ -H "Content-Type: application/json" \ -d '{ "model": "grok-imagine-video", "prompt": "Ocean waves crashing on rocks at sunset, cinematic slow motion", "seconds": "4" }'
参数说明 参数 类型 必填 默认 说明 modelstring 是 — 固定填 grok-imagine-video promptstring 是 — 视频描述,英文最佳 。可写动作、镜头、运镜、光线、风格 secondsstring 否 "4"视频时长(秒),范围 1–15 。按秒计费 ,越长越贵。注意是字符串,如 "10" sizestring 否 "720x1280"分辨率。默认竖屏 720×1280;横屏填 "1280x720"
返回任务信息,记下 task_id
{ "task_id" : "task_mrviW8iu7Y6ij9TKaJQoX5KWCCcgpomb" , "id" : "task_mrviW8iu7Y6ij9TKaJQoX5KWCCcgpomb" , "object" : "video" , "model" : "grok-imagine-video" , "status" : "queued" , "seconds" : "4" , "size" : "720x1280" , "created_at" : 1781857021 }
第 2 步:轮询任务状态 curl https://matrix.000328.xyz/v1/video/generations/{task_id} \ -H "Authorization: Bearer sk-你的Token"
返回的 data.status 状态:
状态 含义 处理 QUEUED排队中 继续轮询 IN_PROGRESS生成中 继续轮询 SUCCESS✅ 完成 从 data.result_url 取视频链接 FAILURE❌ 失败 看 data.fail_reason,失败会自动退款
建议每 5–10 秒 轮询一次。
第 3 步:获取结果 任务完成(SUCCESS)后的返回:
{ "code" : "success" , "data" : { "task_id" : "task_mrviW8iu..." , "status" : "SUCCESS" , "progress" : "100%" , "result_url" : "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-xxxx.mp4" , "data" : { "status" : "done" , "video" : { "url" : "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-xxxx.mp4" , "duration" : 4 } } } }
data.result_url
视频链接同样是临时链接 (数小时内有效),请尽快下载保存。
Python 完整示例 import time import requests BASE = "https://matrix.000328.xyz" HEADERS = { "Authorization" : "Bearer sk-你的Token" , "Content-Type" : "application/json" } # 1. 提交 r = requests.post( f " { BASE } /v1/video/generations" , headers = HEADERS , json = { "model" : "grok-imagine-video" , "prompt" : "a dog running on the beach" , "seconds" : "4" }) task_id = r.json()[ "task_id" ] print ( f "任务已提交: { task_id } " ) # 2. 轮询 for _ in range ( 30 ): time.sleep( 8 ) data = requests.get( f " { BASE } /v1/video/generations/ { task_id } " , headers = HEADERS ).json()[ "data" ] status = data[ "status" ] print ( f "状态: { status } " ) if status == "SUCCESS" : url = data[ "result_url" ] print ( "视频地址:" , url) # 3. 下载 with open ( "output.mp4" , "wb" ) as f: f.write(requests.get(url).content) print ( "已保存为 output.mp4" ) break elif status == "FAILURE" : print ( "生成失败:" , data.get( "fail_reason" )) break
视频生成注意事项
耗时 :一个 4 秒视频通常 30–60 秒生成,时长越长越慢成本 :0.07 / 秒。例 : 4 秒 ≈ 0.07/秒。例:4 秒 ≈ 0.07/ 秒。例 : 4 秒 ≈ 时长可调 :用 seconds 控制,范围 1–15 秒轮询间隔 :建议 5–10 秒,总等待时间留足 5 分钟
常见问题
