Grok Imagine API：用 TokLens 生成图片、改图和视频

2026 年 10 月在 TokLens 上实测核对。价格以定价页为准。

能用哪些模型

改图时每张输入图另计（grok-imagine-image $0.0004，2.0 $0.002）。图生视频时，首帧和参考图每张另计（grok-imagine-video $0.0008，1.5 系列 $0.004）。原价和折后价都列在定价页的「Grok API」卡片里。

生成图片

最简单的请求只要 model 和 prompt：

curl -sS https://hkg.toklens.ai/v1/images/generations \
  -H "Authorization: Bearer $TOKLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-image","prompt":"a red panda reading a newspaper in a Hong Kong tea restaurant, photo"}'

返回的 data[0].url 是一条 10 分钟内有效的下载链接，下载时同样带上 Key。想直接拿图片数据，传 "response_format": "b64_json"。

常用参数：

用 OpenAI 的 Python SDK 时，Grok 特有的参数放在 extra_body 里：

import base64, os
from openai import OpenAI

client = OpenAI(base_url="https://hkg.toklens.ai/v1", api_key=os.environ["TOKLENS_KEY"])
result = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt="a lighthouse at sunset, watercolor",
    response_format="b64_json",
    extra_body={"aspect_ratio": "16:9", "resolution": "2k", "quality": "low"},
)
open("lighthouse.jpg", "wb").write(base64.b64decode(result.data[0].b64_json))

实测速度：grok-imagine-image 1K 约 7 秒、2K 约 17 秒；2.0 的 low 约 15–25 秒，medium 约 50–60 秒。

改图（图生图）

把原图和要怎么改一起发到 POST /images/edits。原图写成 data URL：

curl -sS https://hkg.toklens.ai/v1/images/edits \
  -H "Authorization: Bearer $TOKLENS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-image","prompt":"render this as a pencil sketch","image":"data:image/png;base64,iVBORw0..."}'

• 原图可以是 data URL、multipart 上传的 image 文件，或者之前用同一个 Key 生成的图片的 {"asset_id": "…"}。https 链接不支持，先下载再转成 data URL。
• image 写一张，多张写成 "images": [...]，最多 3 张，提示词里用 <IMAGE_0>、<IMAGE_1> 指代第几张。单张不超过 20 MB，支持 JPEG、PNG、WebP。
• 每次出 1 张。不传 aspect_ratio 时保持原图比例；resolution 和 2.0 的 quality 跟生图一样。实测 grok-imagine-image 1K 改图约 9 秒。
• 很多客户端把原图发到 /images/generations，带了原图的请求会自动按改图处理，计费也一样。

OpenAI 的 Python SDK 用 images.edit，原图走文件上传：

result = client.images.edit(
    model="grok-imagine-image-2.0",
    image=open("cat.png", "rb"),
    prompt="put a party hat on the cat",
    response_format="b64_json",
    extra_body={"quality": "low"},
)

生成视频

视频要分三步：提交、轮询、下载。

1. 提交任务，拿到 request_id。请求头必须带 Idempotency-Key，每个新视频用一个新值；网络重试时带同一个值，不会重复扣费。
2. 每隔几秒查一次 GET /videos/{request_id}，status 从 pending 变成 done。
3. 下载 video.url，同样带上 Key。

curl -sS https://hkg.toklens.ai/v1/videos/generations \
  -H "Authorization: Bearer $TOKLENS_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model":"grok-imagine-video-1.5-lite","prompt":"neon rain on a Hong Kong street","duration":6,"resolution":"720p","aspect_ratio":"21:9"}'
# {"request_id":"vidreq_xxx"}

curl -sS https://hkg.toklens.ai/v1/videos/vidreq_xxx -H "Authorization: Bearer $TOKLENS_KEY"
# {"status":"done","video":{"url":"/v1/media/media_xxx?expires=...","duration":6}}

duration 是 1–15 秒，必须填；aspect_ratio 默认 16:9，resolution 默认 480p。实测 1 秒的 480p 视频 15–30 秒出片，3 秒 720p 约 47 秒。

要用一张图做首帧，加上 image：

{"model": "grok-imagine-video-1.5", "prompt": "the cat turns its head", "duration": 5,
 "image": {"url": "https://example.com/cat.png"}}

image 可以是 https 链接、data URL，或者之前用同一个 Key 生成的图片的 {"asset_id": "…"}。支持 JPEG、PNG、WebP，单张不超过 20 MB。有些网站会拒绝服务器下载图片，遇到 400 时换成 data URL。

怎么算钱

图片按请求的分辨率计价，16:9 的 1k 图虽然输出是 1280×720，仍然按 1K 收。每次请求的明细都在「用量明细」里。

常见报错

完整的参数说明见 用户手册：图片与视频。