认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID
标准值：grok_imagine_image_quality_edit
兼容别名：grok-imagine-image-quality-edit
prompt string 必填
描述所需图片编辑效果的文本指令
image object
需要编辑的单张输入图片. 提供多张输入图片时使用 images
url
string必填JPEG, PNG 或 WebP 格式的公开图片 URL 或 Base64 data URL
type
string图片引用类型
固定值：
image_url
images array<object>
图片编辑使用的多张输入图片. 每个元素使用与 image 相同的结构
url
string必填JPEG, PNG 或 WebP 格式的公开图片 URL 或 Base64 data URL
type
string图片引用类型
固定值：
image_url
n integer
生成的编辑图片数量
默认值：1
response_format string
请求上游图片接口返回的图片格式
可选值：url, b64_json
默认值：url
接口边界
请通过 /model/v1/generation 调用该模型. 该模型当前不通过 OpenAI Images
或 Queue 接口开放.
输入图片行为
单张参考图使用 image, 多张参考图使用 images. Vtrix 生成入口接受公开
图片 URL 和 Base64 data URL. 两个参数中至少需要提供一个.
输出行为
最终任务结果通过 output[].content[].url 返回托管图片地址. 如果上游返回
Base64 图片数据, Vtrix 会上传图片并返回托管 URL, 不会直接暴露原始 Base64 内容.
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息, 仅在状态为 failed 时存在
code
string错误码
message
string详细错误信息
output array
生成结果, 仅在状态为 completed 时存在
content
array生成的资源内容列表
type
string资源类型
值:
image｜videourl
string处理后的资源 URL
jobId
string远端任务 ID
usage object
使用统计, 仅在状态为 completed 时存在
cost
string总费用（美元）
discount
number折扣金额
metadata object
元数据信息