外观
图片生成 API
图片能力使用独立服务入口。先打开图片服务查看当前模型、价格和接口说明,再按照页面提供的 Base URL 与参数接入。
图片服务入口
https://image.reniuniu.win牛API 图片服务查看当前开放的图片模型、计费说明和 API 接入信息
打开图片服务不要把入口地址直接当作 API Base URL
https://image.reniuniu.win 是图片服务入口。实际请求地址、鉴权方式、模型 ID 和参数以图片服务页面当前展示为准,不要照搬文本 API 的 /v1 路径。
接入前先确认
- 图片服务是否展示目标模型及计费说明;
- 图片服务提供的 Key 是否拥有目标模型权限;
- 页面展示的 API Base URL、鉴权方式和请求格式;
- 返回图片的保存方式、有效期和内容安全限制。
能力确认表
若图片服务提供 OpenAI 风格接口,请按下表逐项核对后再编写请求:
| 能力范围 | 常见约定 | 必须从图片服务确认的内容 |
|---|---|---|
| 文生图 | POST /v1/images/generations | 端点是否存在、真实模型 ID、Content-Type、必填参数 |
| 图生图/编辑 | POST /v1/images/edits | 是否支持 multipart、参考图数量和文件限制 |
| 鉴权 | 常见方式为 Bearer Key | 图片服务使用的 Key 类型、权限范围和请求头格式 |
| 请求参数 | model、prompt、尺寸、画质、格式 | 支持字段、枚举值、默认值及优先级 |
| 响应 | 常见为 URL 或 Base64 | 字段结构、临时 URL 有效期和下载要求 |
| SDK | OpenAI 风格 images API | Python、JavaScript SDK 版本与参数兼容性 |
| 错误处理 | 400、401、429、5xx | 内容安全、认证、频率、超时和服务异常含义 |
业务接入前还应覆盖:
- 提示词为空、不安全内容或缺少参数时的返回;
- 图片尺寸、宽高比、画质和输出格式是否互相冲突;
- 单图与多参考图是否支持,以及上传大小和格式限制;
- 客户端超时应如何设置,不预设固定秒数;
- 返回 URL 是否临时有效,是否需要及时下载;
- 图片请求如何计费、失败是否扣费、额度和并发如何计算。
文档不固定填写模型、价格、推荐尺寸或可执行请求示例,避免图片服务更新后产生错误请求和意外计费。以图片服务页面的当前说明为准。
