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。 |