支持原生 JSON 或 multipart/form-data;保留并转发 complexity、markup(含 multipart markup 文件)、svg、frame_count、frame_duration_ms,具体格式依模型和渠道而定。
POST
/v1/images/edits身份验证
Authorizationstring必填使用 OneAster 推理 API Key(Bearer sk-…)。
Authorization: Bearer $ONEASTER_API_KEY
请求正文 · application/json
modelstring必填目录中的公开调用 ID(model_name),不能填写 display_name
promptstring必填图片生成提示词
ninteger生成张数(默认 1,上限 128)
sizestring尺寸规格,如 1024x1024
qualitystring画质档位,依模型能力而定
response_formatstring返回格式,如 url 或 b64_json
output_formatstring输出图片编码格式,依模型能力而定
backgroundstring背景设置,依模型能力而定
watermarkboolean可选水印开关
complexityanyOf可选复杂度或档位(字符串或整数,显式 0 保留并原样转发;依模型和渠道能力而定)
markupanyOf可选标注输入(对象或布尔值,显式 false 保留并原样转发)
svganyOf可选 SVG 扩展配置(对象或布尔值,显式 false 保留并原样转发)
frame_countinteger可选帧数(显式 0 保留并原样转发;依模型和渠道能力而定)
frame_duration_msinteger可选单帧时长毫秒(显式 0 保留并原样转发;依模型和渠道能力而定)
JSON Schema
{
"type": "object",
"required": [
"model",
"prompt"
],
"properties": {
"model": {
"type": "string",
"description": "目录中的公开调用 ID(model_name),不能填写 display_name"
},
"prompt": {
"type": "string",
"description": "图片生成提示词"
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 128,
"description": "生成张数(默认 1,上限 128)"
},
"size": {
"type": "string",
"description": "尺寸规格,如 1024x1024"
},
"quality": {
"type": "string",
"description": "画质档位,依模型能力而定"
},
"response_format": {
"type": "string",
"description": "返回格式,如 url 或 b64_json"
},
"output_format": {
"type": "string",
"description": "输出图片编码格式,依模型能力而定"
},
"background": {
"type": "string",
"description": "背景设置,依模型能力而定"
},
"watermark": {
"type": "boolean",
"description": "可选水印开关"
},
"complexity": {
"description": "可选复杂度或档位(字符串或整数,显式 0 保留并原样转发;依模型和渠道能力而定)",
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"markup": {
"description": "可选标注输入(对象或布尔值,显式 false 保留并原样转发)",
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "boolean"
}
]
},
"svg": {
"description": "可选 SVG 扩展配置(对象或布尔值,显式 false 保留并原样转发)",
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "boolean"
}
]
},
"frame_count": {
"type": "integer",
"minimum": 0,
"description": "可选帧数(显式 0 保留并原样转发;依模型和渠道能力而定)"
},
"frame_duration_ms": {
"type": "integer",
"minimum": 0,
"description": "可选单帧时长毫秒(显式 0 保留并原样转发;依模型和渠道能力而定)"
}
},
"additionalProperties": true
}请求正文 · multipart/form-data
modelstring必填目录中的公开调用 ID(model_name),不能填写 display_name
promptstring必填编辑提示词
imagestring待编辑原图文件
maskstring可选遮罩图片文件
markupstring可选标注图片文件(原样转发)
complexitystring可选复杂度字段
nintegersizestringresponse_formatstringJSON Schema
{
"type": "object",
"required": [
"model",
"prompt"
],
"properties": {
"model": {
"type": "string",
"description": "目录中的公开调用 ID(model_name),不能填写 display_name"
},
"prompt": {
"type": "string",
"description": "编辑提示词"
},
"image": {
"type": "string",
"format": "binary",
"description": "待编辑原图文件"
},
"mask": {
"type": "string",
"format": "binary",
"description": "可选遮罩图片文件"
},
"markup": {
"type": "string",
"format": "binary",
"description": "可选标注图片文件(原样转发)"
},
"complexity": {
"type": "string",
"description": "可选复杂度字段"
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 128
},
"size": {
"type": "string"
},
"response_format": {
"type": "string"
}
},
"additionalProperties": true
}