xAI · 媒体 API

Grok Imagine Quality API

Grok Imagine Quality 是 xAI 在 OmniaKey 上更高保真的图像路由，在相同按次单价下用更多细节换取稍慢的出图。

获取 API Key 查看文档

模型 ID: grok-imagine-image-quality
提供商: xAI
类型: AI 图片
每次成功调用: $0.10
最近核验: 2026-09-11

适用场景

细节和质感比速度更重要时选 Grok Imagine Quality；快速出草稿时改用基础版 Grok Imagine。

能力范围

文生图

把文字提示词生成一张新图片。

接入方式

媒体模型采用异步任务：创建任务、轮询到完成，再下载签名后的资源地址。

创建、轮询、下载

# 1. Create the job. 202 Accepted; the body carries the task id,
#    the pre-charged price, and a poll_url. Reuse one Idempotency-Key
#    across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: grok-imagine-image-quality-001" \
  -d '{
    "model": "grok-imagine-image-quality",
    "type": "image",
    "operation": "generate",
    "input": {"prompt": "a paper boat on a quiet lake at sunset"},
    "parameters": {"size": "1024x1024", "quality": "medium"}
  }'

# 2. Poll GET /v1/media/tasks/{id} until status is
#    succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

# 3. Download assets[0].url before expires_at, or poll again for a
#    fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.png "$(jq -r '.assets[0].url' result.json)"

价格

图像任务按成功调用计费，不按 Token 计费；失败或取消的任务会自动退款。

每次成功调用

$0.10每次调用

常见问题

如何在 OmniaKey 上调用 Grok Imagine Quality？

向 /v1/media/tasks 发送 POST，带上模型 ID、type 设为 "image"、operation 设为 "generate" 或 "edit"。重试时复用同一个 Idempotency-Key，超时就不会再生成第二笔付费任务。

Grok Imagine Quality 如何收费？

Grok Imagine Quality 按 $0.10 每次调用计费。创建时会从预付余额中预扣该金额，失败或取消的任务会自动退款。

为什么接口返回任务 ID 而不是图片？

供应商耗时从几秒到约一分钟不等，OmniaKey 因此把所有图像路由统一为同一套异步流程。轮询 GET /v1/media/tasks/{id}，直到状态变为 succeeded，再读取签名后的资源地址。