图片 API

SDKMAX 提供与 OpenAI 兼容的图片生成 / 编辑接口，实际出图能力由后台接入的图片渠道（如 DALL·E、即梦、Minimax 等）承担，调用方无需关心具体由哪个渠道处理。

生成图片

POST /v1/images/generations

请求示例：

bash

curl https://api.sdkmax.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "一只在赛博朋克城市里骑摩托车的猫",
    "size": "1024x1024",
    "n": 1
  }'

常用参数：

参数	类型	说明
`model`	string	目标模型，如 `dall-e-3`，具体可用模型见控制台模型广场或 `/v1/models`
`prompt`	string	图片描述
`size`	string	图片尺寸，如 `1024x1024`，可选值取决于所选模型
`n`	integer	生成数量，部分模型仅支持 `n=1`
`response_format`	string	`url`（默认）或 `b64_json`

响应示例：

json

{
  "created": 1717000000,
  "data": [{ "url": "https://.../generated-image.png" }]
}

编辑图片

POST /v1/images/edits

用于对已有图片做局部重绘/编辑，使用 multipart/form-data 上传原图与（可选）蒙版：

bash

curl https://api.sdkmax.com/v1/images/edits \
  -H "Authorization: Bearer sk-你的密钥" \
  -F image="@original.png" \
  -F mask="@mask.png" \
  -F prompt="把背景换成星空" \
  -F model="dall-e-2"

暂不支持

POST /v1/images/variations（图片变体）目前未实现，调用会返回未支持错误。如果业务依赖该能力，建议改用「编辑」接口配合提示词，或关注后续版本更新。

用 SDK 调用

python

resp = client.images.generate(
    model="dall-e-3",
    prompt="一只在赛博朋克城市里骑摩托车的猫",
    size="1024x1024",
)
print(resp.data[0].url)

其它语言用法见 Python · Node.js · Java · Go。

错误处理

图片生成常见错误包括模型不支持所请求的尺寸/参数（400）、模型不可用（model_not_found）、内容被安全策略拦截（sensitive_words_detected）等，完整列表见错误码。

图片 API ​

生成图片 ​

编辑图片 ​

暂不支持 ​