模型名称

i2i_outpainting

说明
调用 GPTNB 的火山视觉代理能力 i2i_outpainting，对单张图片做 AI 扩图，并同步返回结果。

请求

Method：POST
Content-Type：application/json
路径：/v1/app/tools/i2i_outpainting

请求头

Header	必填	说明
Authorization	是	平台 Token，支持 `Bearer <token>` 或直接 token。

请求参数

参数	类型	必填	说明
model	string	是	固定传 `i2i_outpainting`。
image_url	string	是	输入图片 URL，需公网可访问。
custom_prompt	string	否	补充扩图提示词，建议简洁明确，100 字以内。
top	float	否	向上扩展比例，范围 `0-1`。
bottom	float	否	向下扩展比例，范围 `0-1`。
left	float	否	向左扩展比例，范围 `0-1`。
right	float	否	向右扩展比例，范围 `0-1`。
steps	int	否	采样步数。
strength	float	否	文本控制强度，范围 `0.1-1.0`。
scale	float	否	文本引导强度，范围 `1-20`。
seed	int	否	随机种子，`-1` 表示随机。
max_height	int	否	输出图最大高度。
max_width	int	否	输出图最大宽度。

图片限制（服务端校验）

图片格式：JPG、JPEG、PNG

图片大小：不超过 5MB

图片分辨率：最小 64×64，最大 4096×4096

image_url 需能直接访问并返回 HTTP 200

成功响应（示例）

{
  "trace_id": "c4d8e2b0f61d9fd81776103600",
  "status": "success",
  "data": {
    "image_urls": [
      "https://example.com/outpainting-result.jpg"
    ],
    "task_id": "7392616336519610409"
  },
  "image_urls": [
    "https://example.com/outpainting-result.jpg"
  ],
  "task_id": "7392616336519610409",
  "request_id": "20240720103939AF0029465CF6A74E51EC",
  "message": "Success",
  "money": "0.1000"
}

响应字段

字段	类型	说明
trace_id	string	平台任务追踪 ID
status	string	成功时固定为 `success`
data	object	上游返回的数据对象
image_urls	array	结果图片地址列表
task_id	string\|null	上游返回的任务 ID
request_id	string\|null	上游请求 ID
message	string	上游返回信息
money	string	本次接口计费金额

错误响应（示例）

{
  "error": {
    "message": "image_url 格式不正确",
    "type": "invalid_request_error",
    "param": null,
    "code": null
  }
}

常见错误：

model 不能为空

模型不存在或未启用

缺少 image_url 参数

image_url 格式不正确

图片校验失败（大小 / 分辨率 / 格式 / 访问失败）

top 取值范围应为 0 - 1

strength 取值范围应为 0.1 - 1

scale 取值范围应为 1 - 20

当前源站未配置接口地址

当前源站未配置 API Key

上游风控或代理站返回失败信息

说明

该工具为同步接口，不提供任务查询路由。

平台请求的是 GPTNB 火山视觉代理站，业务参数与原始 i2i_outpainting 能力保持一致。

成功时直接返回结果图 URL，平台不额外做转存。

AI扩图

模型名称#

请求#

请求头#

请求参数#

图片限制（服务端校验）#

成功响应（示例）#

响应字段#

错误响应（示例）#

说明#