文档首页/Bypass OpenAI 图片编辑

Bypass OpenAI 图片编辑

原厂协议与认证

使用 XHub 公开模型名及虚拟密钥;部署必须启用对应 Bypass 协议。网关替换上游模型名并注入部署凭据,保留原厂扩展字段,同时执行权限和计费;Bypass 不执行标准入口的调用前文本护栏链。客户端发送 Authorization: Bearer $XHUB_API_KEY。模型支持由部署决定,不表示所有原厂模型自动可用。

接口概述

图片编辑

图片编辑

接口行为

让 curl 设置 multipart boundary。部分原生部署接受 JSON 引用,请匹配协议。

接口与认证

POST /bypass/openai/v1/images/edits

使用 XHub API 密钥:Authorization: Bearer 。不要把供应商密钥当作网关密钥。

Base URL 使用调试台显示的网关根地址,不额外追加 /v1;实际请求使用上面的完整接口路径。

请求示例

curl "$XHUB_BASE_URL/bypass/openai/v1/images/edits" \
  -H "Authorization: Bearer $XHUB_API_KEY" \
  -F "model=YOUR_MODEL_NAME" -F "image=@source.png" \
  -F "prompt=Add a small lighthouse."

请求参数

字段 类型 说明
model string · required 公开模型名,部署必须支持此协议。
image file array · required
prompt / mask string / file 编辑指令与可选遮罩。

成功响应

{
  "data": [
    {
      "b64_json": "BASE64_IMAGE_DATA"
    }
  ]
}
字段 类型
data object[]
data[].b64_json string

错误与排查

HTTP 说明
400 请求无效,请检查 JSON、参数和查询。
401 XHub 凭据缺失或无效。
403 权限拒绝,请检查模型范围或策略。
429 超过限制,请检查响应详情与 Retry-After。

输入关键词搜索全文,例如:预算、路由、Docker