鬼魅云文档中心

Appearance

v1 接口 · 图片生成与编辑 · OpenAI 兼容

图片生成与编辑接口

这里聚焦图像相关接口。统一入口同样是 https://gvmz.systems/v1，图片生成使用 /v1/images/generations，编辑图像使用 /v1/images/edits/。

在线测试 ​

可以直接在这里选择图片生成模型进行测试。模型列表和模型页共用同一个 /api/pricing 数据源。

(图片生成接口使用非流式响应以便直接预览图片)
Curl 命令预览

快速入口 ​

/v1/images/generations适合直接生成图片，兼容 OpenAI 原生图片生成接口风格。/v1/images/edits适合在原始图片基础上做编辑、扩展或局部改写。

图片生成 ​

接口信息 ​

完整地址

https://gvmz.systems/v1/images/generations

请求方法

POST /v1/images/generations

统一鉴权

Authorization: Bearer sk-xxxxx

请求参数 ​

字段必填说明
model是支持所有图片生成模型
prompt是提示词
image否参考图，支持 base64 或 URL
size否形如 1024x1024
response_format否目前示例值是 url

size 的常用写法和 gpt-image-2 等模型保持一致，直接填像素规格即可。

示例请求 ​

json
{
  "model": "gpt-image-2",
  "prompt": "生成一张蓝色科技风的文档首页插图",
  "image": [],
  "size": "1024x1024",
  "response_format": "url"
}

返回说明 ​

json
{
  "created": 1777689832,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ],
  "usage": {
    "total_tokens": 6267,
    "input_tokens": 17,
    "output_tokens": 6250
  }
}
什么时候优先用这个接口？

如果你只想拿到一张图的直链，而不是走聊天式多轮交互，这个接口通常是最直接的选择。聊天和文本相关测试请看 Curl 页面；这里专注图片生成。

编辑图像 ​

编辑图像接口会基于你提供的原始图片和提示词生成新图片，适合换背景、局部改写、风格调整或扩展画面。

完整地址

https://gvmz.systems/v1/images/edits/

请求方法

POST /v1/images/edits/

必需输入

image + prompt

这个接口必须提供原始图片。通常会用表单方式上传图片文件，再附上编辑提示词和输出规格。

示例请求 ​

bash
curl https://gvmz.systems/v1/images/edits/ \
  -H 'Authorization: Bearer {此处填写ApiKey}' \
  -F 'image=@./input.png' \
  -F 'prompt=把背景改成淡蓝色科技风，并保留主体人物' \
  -F 'size=1024x1024' \
  -F 'response_format=url'

返回说明 ​

json
{
  "created": 1777689832,
  "data": [
    {
      "url": "https://example.com/edited-image.png"
    }
  ],
  "usage": {
    "total_tokens": 7120,
    "input_tokens": 58,
    "output_tokens": 7062
  }
}
什么时候优先用这个接口？

如果你已经有一张原始图片，并且希望在此基础上进行编辑或扩展，就优先使用这个接口。纯生成图片仍然使用上面的 /v1/images/generations。

上一步 / 下一步 ​

上一步：Curl 调用示例先用文本接口验证 Key、BaseURL 和模型名是否正常。下一步：OpenCode 接入接口验证完成后，继续把配置接入到实际工具中。