Skip to main content
POST
编辑图像
基于已有图像和文本提示生成修改后的图像。请求使用 multipart/form-data 提交,原图放在 image 字段。
下面的代码块是完整请求,可以直接复制运行。先把 HILINKUP_API_KEY 设为你的真实密钥,并把 model 替换为 GET /v1/models 返回的、支持图像编辑的模型 ID。

请求参数

string
必填
支持图像编辑的模型 ID。并非所有图像生成模型都支持编辑。
string
必填
描述修改目标的文本提示。描述得越具体,保留原图特征的效果越稳定。
file
必填
要编辑的原图文件。支持的格式和大小由模型决定。
integer
默认值:"1"
要生成的图像数量。部分模型只支持 1。
string
输出图像尺寸。可用值由模型决定。

请求示例

响应

integer
生成结果的 Unix 时间戳。
array
图像结果列表,每项包含 url 或 b64_json。
返回值可能是临时 URL,也可能是 Base64 数据(通常为 b64_json 字段)。请在有效期内下载并保存结果。

保存生成结果

示例中的模型 ID、响应字段和 URL 仅用于说明请求格式。请先通过模型列表或控制台确认当前账户可用的图像编辑模型、输入图限制和输出尺寸。
提示词里明确说明「保持不变」的部分(背景、构图、人物特征)通常能减少无关改动,但不同模型的遵循程度不同。

下一步

只需要从文本生成新图像时,使用生成图像。

授权

Authorization
string
header
必填

在控制台创建的 API Key,格式为 Authorization: Bearer HILINKUP_API_KEY。

请求体

multipart/form-data
model
string
必填

支持图像编辑的模型 ID。并非所有图像生成模型都支持编辑。

prompt
string
必填

描述修改目标的文本提示。

image
file
必填

要编辑的原图文件。支持的格式和大小由模型决定。

n
integer
默认值:1

要生成的图像数量。部分模型只支持 1。

size
string

输出图像尺寸。可用值由模型决定。

响应

200 - application/json

图像编辑结果

created
integer

生成结果的 Unix 时间戳。

data
object[]
最后修改于 2026年10月8日