4SToken
API Reference

接口参考

按接口拆分查看请求地址、输入参数、输出参数与错误代码。

编程工具接入模型与价格
Gateway Protocols多标准协议兼容
OpenAIAnthropicGeminiOpenRouter
Chat / Responses / Messages / Claude Messages
POST /v1/images/edits

图生图 / 图片编辑

参考图生图、多图融合、局部重绘等图片编辑能力。

上一页下一页

接口信息

请求地址https://api.4stoken.cn
请求路径/v1/images/edits
请求方式POST
协议标准OpenAI Images
能力分类图像编辑
Content-Typemultipart/form-data
鉴权Authorization: Bearer sk-...

输入参数

参数类型必填说明
modelstring是图片编辑模型编码。
promptstring是编辑提示词。
imagefile | file[]是参考图文件；多图时重复传 image 表单字段。
maskfile否局部重绘 mask。
ninteger否生成数量。
sizestring否宽高比或尺寸。
backgroundstring否输出背景模式，例如 opaque / transparent；是否生效取决于模型。
output_formatstring否输出图片文件格式，例如 png / jpeg / webp；是否生效取决于模型。
asyncboolean否网关扩展：异步提交任务；不属于 OpenAI Images 标准。
callbackUrlstring否网关扩展：任务完成回调地址；不属于 OpenAI Images 标准。

输出参数

参数类型返回说明
createdinteger同步时同步出图创建时间。
data[].urlstring成功时生成图片 URL；同步结果默认先上传 COS 后返回该字段。
data[].b64_jsonstring兼容保留base64 图片内容；仅兼容旧链路或特定 response_format，不建议依赖。
backgroundstring否输出背景模式，例如 opaque / transparent。
output_formatstring否生成图片文件格式，例如 png / jpeg。
qualitystring否生成质量档位，例如 low / standard / hd；具体取值取决于模型线路。
sizestring否生成图片尺寸，例如 1024x1024。
usageobject否图片生成 token 用量统计。
usage.input_tokensinteger否输入 token 数。
usage.input_tokens_details.image_tokensinteger否输入图片 token 数。
usage.input_tokens_details.text_tokensinteger否输入文本 token 数。
usage.output_tokensinteger否输出 token 数。
usage.output_tokens_details.image_tokensinteger否输出图片 token 数。
usage.output_tokens_details.text_tokensinteger否输出文本 token 数。
usage.total_tokensinteger否总 token 数。
task_idstring是网关本地任务 ID；同步/异步均返回，可用于查询任务结果；不属于 OpenAI Images 标准。
taskIdstring是同 task_id，返回给下游使用的网关本地任务 ID；不属于 OpenAI Images 标准。
statusstring异步时任务状态。

补充说明

  • 返回格式由 Gateway 入口决定：调用 /v1/images/edits 时始终返回 Gateway 图片编辑任务格式。
  • Gateway 扩展字段 image_size、async、callbackUrl 不属于 OpenAI Images 标准。
  • 灰度兼容：Portal 预览同时兼容旧版 { result: { data: [...] } } 包装和新版顶层 data[].url。

错误代码

HTTP 状态码错误说明
400Bad Request缺少图片、mask 不被线路支持或参数格式错误。
401UnauthorizedClient Key 无效或未提供。
402Payment RequiredClient Key 配额或消费限额超限。

在线调试

model
your-model-code

仅展示该接口支持的已发布模型

暂无可用模型 →
更多配置网关扩展callbackUrl=异步任务
async
false（同步等待结果）
callbackUrl
关
size

宽高比或像素尺寸，如 1:1；网关按 size 推断计费档位

1:1
n

生成张数

curl -X POST 'https://api.4stoken.cn/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'model=your-model-code' \
  -F 'prompt=Hello' \
  -F 'image=@/path/to/reference.png' \
  -F 'size=1:1' \
  -F 'n=1' \
  # 可选: -F 'mask=@/path/to/mask.png'
该接口需要上传本地文件，网页调试面板暂不直连发送 multipart；请复制左侧代码在本地带文件调用。