提交图片编辑任务

接入信息	值
Base URL	`https://api.starcore.cloud`
请求	`POST /v1/images/edits`
鉴权	`Authorization: Bearer <YOUR_API_KEY>`
请求格式	`multipart/form-data 或 application/json`

提交后保存响应 id，使用对应查询接口获取结果。任务以异步方式处理，无需传 async。

选择一种输入方式

输入	请求格式	图片字段
本地文件	multipart/form-data	单图 image；多图重复 image[]
图片 URL	application/json	images 数组，每项包含 image_url

model、prompt 必填；可用尺寸、数量和画质以模型为准。

文件与 URL 方式不能混用。mask 为可选 PNG 蒙版，仅支持该能力的模型可用。

文件上传导入后，在 Body 为 image / image[] 选择本地文件。不要手动设置 Content-Type，工具会自动生成 boundary。

URL 素材限制

项目	要求
地址	公网 HTTPS 直链，仅支持 443 端口；需鉴权的地址请提供有效签名
格式	原图 PNG / JPEG / WebP；蒙版 PNG
数量	最多 16 张原图、1 张蒙版；实际以模型能力为准
大小	单文件 ≤ 20 MiB，合计 ≤ 32 MiB
下载超时	60 秒
不支持	重定向、内网地址、file_id、Base64

URL 下载失败不创建任务、不扣费。

cURL 示例

整段复制到 Apipost / Apifox 的 cURL 导入，替换 <YOUR_API_KEY> 后使用。

URL 图片编辑

替换为真实可访问的 HTTPS 图片直链。

错误定位

参数错误返回 HTTP 400：error.param 指明字段，error.code 区分缺少参数、类型错误、值不合法和 JSON 语法错误。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数

application/json

必填

示例

单图URL编辑多图URL编辑（需模型支持）

{
    "model": "gpt-image-2.5-flare",
    "prompt": "保留主体，只把背景改为浅蓝色。",
    "images": [
        {
            "image_url": "https://example.com/source.png"
        }
    ],
    "n": 1,
    "size": "1024x1024"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

选择一种输入方式#

URL 素材限制#

cURL 示例#

URL 图片编辑#

错误定位#