Venice 图片生成

解决什么问题

把 Venice 的文生图能力接进现有应用时，通常会撞上两个问题：接口参数面太宽，而且不同模型的尺寸、风格和参考图约束各不相同。这个技能把两套请求路径收进同一个工具里，让调用方不必自己维护请求映射和错误分类逻辑。

核心能力

• 双路径设计

- POST /api/v1/image/generate 是 Venice 原生接口，支持 negative_prompt、cfg_scale、seed、style_preset 和 style_references，一次调用可返回最多 4 个变体。
- POST /api/v1/images/generations 是 OpenAI 兼容接口，字段对齐 openai.images.generate()。适合已经基于 OpenAI SDK 编写代码的场景，可以直接切换 base URL，但该路径一次调用只返回单张图片。

• 按模型能力收缩参数

技能通过 GET /models?type=image 提供每个模型的 model_spec，包括 promptCharacterLimit、widthHeightDivisor、steps、resolutions 和 aspectRatios。调用方可以先探测约束再构造请求，减少 400 错误的试错成本。

• 风格预设预检

GET /api/v1/image/styles 返回可用的 style_preset 名称列表，列表较小且稳定，适合拉取后本地缓存。

使用流程

1. 先查询模型列表，确认目标模型支持的尺寸模式、提示词上限和风格参考能力。
2. 如果沿用 OpenAI SDK，使用兼容端点并按文档映射字段；如果需要负向提示词、多变体或风格参考，切到原生端点。
3. 构造请求时按需设置 width/height、aspect_ratio 或 resolution，确保符合模型约束。
4. 通过 return_binary 控制响应是二进制图像还是 JSON 里的 base64；注意 variants > 1 时必须保持 return_binary: false。
5. 若要让生成图匹配既有图片风格，只对 supportsStyleReferences: true 的模型使用 style_references，并在 prompt 里描述主体，让参考图承载风格。

适用边界与注意点

• width 和 height 必须能被对应模型的 widthHeightDivisor 整除，否则会触发 400。
• steps 对部分 fast/turbo 模型无效，这些模型会在服务端内部硬编码步数。
• hide_watermark: true 是声明性设置，被判定为安全策略命中的内容仍可能带水印。
• 旧的 inpaint 字段已废弃，不应继续使用。
• OpenAI 兼容端点的 response_format: "url" 返回的是 data URL，不是可公开访问的托管地址，落盘或转存时需要自行解码。