图片生成

使用已启用的模型生成或编辑图像，并在模型广场核对路由价格。

使用 Zashmodel API 密钥和已启用的图像模型。模型 ID、路由权限、参数和价格以当前模型目录为准，不沿用其他站点的生图套餐。

生成前先核对路由

在模型详情页确认是否支持图像生成或编辑，以及对应计费单位。文本模型密钥或公开目录中的模型条目，不会自动授予图像调用权限。

查看模型与价格 →

选择模型和 API 密钥

  1. 找到支持所需图像接口的模型，并复制准确 ID。
  2. 创建可访问该模型路由且额度充足的密钥，并单独检查账号余额。
  3. 将 ZASHMODEL_MODEL 设置为该图像模型 ID，并使用下方环境变量。

API Key 与访问权限 →

环境变量
export ZASHMODEL_API_KEY="YOUR_API_KEY"
export ZASHMODEL_BASE_URL="https://zashmodel.com/v1"
export ZASHMODEL_MODEL="YOUR_MODEL_ID"

图像接口

图像接口
适用场景端点Content-Type
生成图像POST /v1/images/generationsapplication/json
编辑图像POST /v1/images/editsmultipart/form-data

OpenAI 兼容接口地址: https://zashmodel.com/v1

生成图像

此最小示例使用你选择的图像模型，并保存 JSON 响应。确认模型支持后，再添加可选参数。

POST /v1/images/generations
curl --fail-with-body "$ZASHMODEL_BASE_URL/images/generations" \
  -H "Authorization: Bearer $ZASHMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- -o generation.json <<JSON
{
  "model": "$ZASHMODEL_MODEL",
  "prompt": "A white ceramic cup on a grey table, soft natural light"
}
JSON

编辑图像

将 source.png 放在当前目录。不要手动设置 Content-Type，让 cURL 自动生成 multipart 边界；所选模型必须支持编辑。

POST /v1/images/edits
curl --fail-with-body "$ZASHMODEL_BASE_URL/images/edits" \
  -H "Authorization: Bearer $ZASHMODEL_API_KEY" \
  -F "model=$ZASHMODEL_MODEL" \
  -F "image=@source.png" \
  -F "prompt=Keep the composition and lighting; make the cup dark blue." \
  -o edit.json

可选图像参数

可选图像参数
参数要求说明信息
model必填填写该密钥有权使用的准确图像模型 ID。
prompt必填描述要生成的图像，或需要进行的修改。
size / quality / n取决于模型可用尺寸、质量档位和图片数量取决于模型与路由。
background / output_format取决于模型传入这些字段前，先确认模型是否支持透明背景和对应输出格式。
image编辑时使用此 multipart 示例上传一张本地参考图。
response_format取决于模型部分模型返回 Base64，其他模型可能返回临时 URL，请以所选模型的响应格式为准。

URL 参考图、多图、蒙版和流式响应的支持情况因路由而异。请查看具体模型说明，不要默认所有路由都支持这些能力。

读取和保存结果

  • 处理 data 前先检查 error。保存下来的 JSON 文件可能是错误响应，而非图像结果。
  • 如果 data 中包含 b64_json，请解码 Base64 并按实际输出格式保存；如果包含 url，请在地址失效前下载文件。
  • 需要长期留存时，请将结果保存到自己的应用或存储中，并遵循当前服务的数据处理政策。

计费与重试

本指南不设定统一图像价格或尺寸加价规则。请在模型广场核对按张或按 token 计费、路由倍率与参数条件，并以调用日志核对最终费用。

高分辨率图像和复杂编辑可能耗时较长。超时后先查看请求日志再决定是否重试；客户端超时并不代表上游已经停止处理。

调用日志 → · 故障排查 →