图片生成 API
图片生成将复用统一 Base URL 与专用 Key。当前能力尚未完成牛API实测,本页是验证清单,不是可用接口声明。
待确认,不要直接用于生产
目前没有牛API实测证据证明图片生成可用。不要根据本页直接调用生产服务,也不要使用第三方平台的模型 ID、尺寸或参数值。验证完成后,本页会更新为正式接入文档并录入统一数据源。
验证前可以先确认的事
- 控制台是否展示图片类模型 ID;
- 专用 Key 的模型权限是否覆盖该模型;
- 图片请求是否与文本接口共用
https://api.reniuniu.win/v1和同一认证方式。
验证清单
若牛API后续确认提供 OpenAI 风格图片能力,应按以下清单逐项验证并记录到统一数据源:
| 验证范围 | 候选约定 | 必须确认的内容 |
|---|---|---|
| 文生图 | POST /v1/images/generations | 端点是否存在、真实模型 ID、Content-Type、必填参数 |
| 图生图/编辑 | POST /v1/images/edits | 是否支持 multipart、参考图数量和文件限制 |
| 鉴权 | Bearer Key 候选 | 是否与文本接口共用 Base URL 和 Key 权限 |
| 请求参数 | model、prompt、尺寸、画质、格式 | 支持字段、枚举值、默认值及优先级 |
| 响应 | URL 或 Base64 候选 | 字段结构、临时 URL 有效期和下载要求 |
| SDK | OpenAI 风格 images API 候选 | Python、JavaScript SDK 版本与参数兼容性 |
| 错误处理 | 400、401、429、5xx | 内容安全、认证、频率、超时和服务异常含义 |
验证时还应覆盖:
- 提示词为空、不安全内容或缺少参数时的返回;
- 图片尺寸、宽高比、画质和输出格式是否互相冲突;
- 单图与多参考图是否支持,以及上传大小和格式限制;
- 客户端超时应如何设置,不预设固定秒数;
- 返回 URL 是否临时有效,是否需要及时下载;
- 图片请求如何计费、失败是否扣费、额度和并发如何计算。
在这些结论完成实测前,文档不会提供图片模型、价格、推荐尺寸或可执行请求示例。