词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！

AI大模型API接入-图片模型接口

AI大模型API接入-图片模型接口

API端点模型支持的接口端点信息

图片修改接口
post OpenAI image edit
https://api.tokpub.com/v1/images/edits

图片生成接口
post image-generation
https://api.tokpub.com/v1/images/generations

备注: 以上接口必须图片模型才能支持，以下内容只作为参考

API端点信息汇总

代理地址：https://api.tokpub.com，兼容OpenAI图像接口协议

接口名称	请求方式	接口端点URL	编码格式	功能说明
图片修改接口（Image Edit）	POST	`https://api.tokpub.com/v1/images/edits`	`multipart/form‑data`	局部编辑/图生图，基于原图+蒙版修改指定区域（Inpaint）
图片生成接口（Image Generation）	POST	`https://api.tokpub.com/v1/images/generations`	`application/json`	文生图，纯文本提示词全新生成图片

1、图片修改接口 /v1/images/edits 请求参数表（multipart/form‑data）

参数名	类型	是否必填	默认值	说明
image	file	✅必填	-	待编辑原图；PNG格式、≤4MB；正方形；若无mask，则图片必须带透明通道，透明区域作为编辑区域
prompt	string	✅必填	-	编辑描述提示词，最大1000字符，描述希望修改成什么效果
mask	file	❌选填	-	蒙版PNG，必须和image尺寸完全一致；完全透明Alpha=0像素代表需要重绘编辑的区域；不填则复用image自带透明通道
model	string	✅必填	-	图像编辑模型，如`dall‑e‑2`、`gpt‑image‑1`等
n	integer	❌选填	1	生成图片数量；取值1‑10；部分模型仅支持n=1
size	string	❌选填	1024x1024	输出图片尺寸；DALL‑E2：`256x256`/`512x512`/`1024x1024`；DALL‑E3支持`1792x1024`、`1024x1792`
response_format	string	❌选填	url	返回格式；`url`返回临时图片链接；`b64_json`返回base64图片字符串
user	string	❌选填	-	终端用户唯一标识，用于风控、滥用检测

/v1/images/edits 响应参数（200‑OK JSON）

字段	类型	说明
created	integer	Unix时间戳，任务创建秒级时间
data	array[object]	图片结果数组
data[].url	string	图片临时访问链接，response_format=url时返回
data[].b64_json	string	base64图片编码串，response_format=b64_json返回

2、图片生成接口 /v1/images/generations 请求参数表（application/json）

参数名	类型	是否必填	默认值	说明
model	string	✅必填	-	生图模型；如`dall‑e‑2`、`dall‑e‑3`、`gpt‑image‑2`
prompt	string	✅必填	-	生成图片的文本提示词，DALL‑E2最大1000字符，DALL‑E3最大4000字符
n	integer	❌选填	1	生成图片数量，DALL‑E3仅支持n=1；DALL‑E2取值1‑10
size	string	❌选填	1024x1024	输出尺寸；DALL‑E2：`256x256`/`512x512`/`1024x1024`；DALL‑E3：`1024x1024`、`1792x1024`、`1024x1792`
quality	string	❌选填	standard	仅DALL‑E3支持；`standard`标准速度；`hd`高清，细节更强，耗时更长
response_format	string	❌选填	url	返回格式：`url`临时链接 / `b64_json` base64编码串
style	string	❌选填	vivid	DALL‑E3；`vivid`超写实；`natural`自然柔和
user	string	❌选填	-	终端用户标识，风控用途

/v1/images/generations 响应参数（200‑OK JSON）

字段	类型	说明
created	integer	Unix时间戳，请求创建时间（秒）
data	array[object]	生成图片结果列表
data[].url	string	图片临时url（response_format=url）
data[].b64_json	string	base64编码图片（response_format=b64_json）

请求Header公共配置

cURL调用示例

图片生成 generations

图片编辑 edits

edits接口是multipart表单，不能使用json body

注意事项

1.

/v1/images/edits 不支持DALL‑E3，仅DALL‑E2等支持图编辑能力。

2.

返回url为短期临时链接，通常24小时失效，业务需要及时下载保存图片。

3.

mask只识别完全透明像素，半透明不会作为编辑区域；原图与mask图片分辨率必须完全一致，否则报错。

AI大模型API测试和调试

AI大模型API接入-文生图测试