4SToken
API Reference

接口参考

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

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

图生图 / 图片编辑

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

上一页 下一页

接口信息

请求地址https://api.4stoken.cn
请求路径/v1/images/edits
请求方式POST
Content-Typemultipart/form-data
鉴权Authorization: Bearer sk-...

输入参数

参数类型必填说明
modelstring是图片编辑模型编码。
promptstring是编辑提示词。
imagefile | file[]是参考图文件；多图时重复传 image 表单字段。
maskfile否局部重绘 mask。
ninteger否生成数量。
sizestring否宽高比或尺寸。
image_sizestring否分辨率档位。
asyncboolean否true 时返回任务 ID。
callbackUrlstring否异步任务完成后的回调地址。

输出参数

参数类型返回说明
createdinteger同步时同步出图创建时间。
data[].urlstring成功时生成图片 URL；同步结果默认先上传 COS 后返回该字段。
data[].b64_jsonstring兼容保留base64 图片内容；仅兼容旧链路或特定 response_format，不建议依赖。
usageobject否图片生成 token 用量统计。
task_idstring是网关本地任务 ID；同步/异步均返回，可用于查询任务结果。
taskIdstring是同 task_id，返回给下游使用的网关本地任务 ID。
statusstring异步时任务状态。

补充说明

  • 回调接口：请求中传 callbackUrl 后，Gateway 会在图片任务成功后向该地址发起 POST，Content-Type 为 application/json。
  • 回调 body 与 GET /v1/images/tasks/{taskId} 的成功响应一致，顶层直接包含 task_id、taskId、status、data、usage、error 等字段。
  • 灰度兼容：Portal 预览同时兼容旧版 { result: { data: [...] } } 包装和新版顶层 data[].url。

错误代码

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

示例

请求示例

curl -X POST "$GATEWAY_API_BASE/v1/images/edits" \
  -H "Authorization: Bearer sk-..." \
  -F "model=your-image-model" \
  -F "prompt=融合两张参考图，保留主体并替换为蓝色背景" \
  -F "image=@/path/to/subject.png" \
  -F "image=@/path/to/background-reference.png" \
  -F "size=1:1"

响应示例

{
  "created": 1710000000,
  "task_id": "img-202406010001",
  "taskId": "img-202406010001",
  "data": [
    {
      "url": "https://example.com/generated/image.png"
    }
  ],
  "usage": {
    "input_tokens": 7148,
    "output_tokens": 7024,
    "total_tokens": 14172,
    "input_tokens_details": {},
    "output_tokens_details": {}
  }
}