图像模型

选择模型

先调用 GET /v1/models 获取当前可用模型，并使用响应中的 ID 作为 model。 可用模型、参数和价格会随渠道变化，请不要依赖文档中的固定模型列表。

生成图片

按所选模型的提供商兼容格式提交图像生成请求。请求是否同步完成取决于模型；收到任务响应时，请按异步任务处理。

curl https://api.mindon.fun/v1/images/generations \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "model": "your-image-model-id",
    "prompt": "一座日落时的未来城市",
    "n": 1
  }'

编辑图片

图像编辑同样使用模型所支持的提供商兼容请求体。提交前确认模型支持输入图片、遮罩或编辑提示；不支持的字段或尺寸会返回请求错误。

{
  "model": "your-image-model-id",
  "prompt": "描述期望的编辑结果",
  "image": "https://example.com/source.png"
}

读取结果

异步任务在状态进入终态前尚未完成。轮询模型或渠道返回的任务查询地址，直到状态为成功、失败或提供商定义的其他终态。响应正文定义最终输出 URL 和错误字段；请以该响应为准，不要假定固定字段名或 URL 有效期。

输入资源

使用外部图片或资源 URL 时，资源必须保持可访问，直到提供商抓取完成。私有 URL、过期签名 URL 或过早删除的文件会导致任务失败。对大文件或访问受限资源，请先上传到你可控且可访问的存储。