Nolibox API 详细介绍
开始使用
请进入开放平台：open.creator.nolibox.com（使用电脑浏览器打开），注册用户并登录系统，在应用列表内获取app-key和app-secret，这将做为所有接口调用时的鉴权标识。
<img src=https://api.apifox.com/api/v1/projects/3638100/resources/411020/image-preview width=70%>
用户类型和费用逻辑
不同用户类型使用 API 的计费逻辑不同，常见的主要有两类用户：
| 积分用户 | 专机用户 | |
|---|---|---|
| 算力 | 公共算力（多租户共享） | 专用算力（单租户专享） |
| 计费逻辑 | 购买积分（credit），开放平台内的所有 API 功能都可通过消耗积分来使用，不同功能的 API 消耗积分数量不同 | 调用次数（number_of_times）只能在与之对应的功能上使用，购买时需确定好购买什么功能、购买多少次调用、搭配什么型号、几张 GPU 算力的专机 |
| 使用体验 | 1. 在积分余额充足的情况下，我们并不限制积分用户提交任务的数量 2. 由于积分用户使用的是多租户共享算力，因此我们对 API 的计算时长不做担保 3. 我们在排队机制上尽量做到积分用户体验一致，实施“按人头排队”而不是“按任务排队”，尽量避免了“某个积分用户大批量提交任务从而阻塞其他积分用户任务执行”的情况 4. 我们会根据积分用户的数量增加公共算力 5. 积分用户不支持专属模型的部署 | 1. 在该功能的调用次数余额充足的情况下，不限制专机用户对该功能的提交数量 2. 专机用户专享单独的任务队列 3. 专机用户专享单独的算力资源，因此对不同算力对应的生成时间可测算 4.专机的 app-key 也可以充值积分、通过积分使用平台内的其他功能 5. 专机用户支持专属模型部署，一些新功能、好效果将优先开放给专机用户使用 |
| 适用类型 | 1. 初步尝试、用量较少的企业 2. 个人开发者、流量较少的应用 | 1. 工作场景、规律出图的企业 2. 流量规模较大的应用 |
| 预算范围 | 每次充值1000元起 | 每月万元级消耗 |
| 付款方式 | 预购积分，使用时消耗 | 公对公转账预购调用次数，使用时消耗 |
| 成为方式 | 平台内扫码自助购买 | 联系商务 |
注：以上为平台内标准API的使用方式，对模型、功能、效果有定制需求的用户均需布设专机
功能目录
专机用户部署介绍
以下内容主要针对业务类型很多、都做专机部署的用户，指导这些用户“哪些功能需要要租多少GPU显卡”的问题，一般用户不会涉及到。
专机用户即为单租户，不同于积分用户的任务会发到公共算力集群，我们会为专机用户提供专用算力，不存在和他人一起排队的情况，从而做到生成速度可预测、可配置的服务标准。
专机用户购买的是服务次数，某个服务内可能有多个API可调用，需注意：
- 相同服务内的多个 API 可共享该服务的剩余调用次数，不同服务间的 API 无法共享调用次数
例如：某用户购买了 1 万次商品场景图生成功能，只能用来生成 1 万张商品场景图，而不能用于抠图等其他功能
- 专机的本质是为专机用户开设专用的集群。但并不是所有服务都能部署在相同的 GPU 上。目前主要有A、B两类服务，两套集群能支持的服务并不兼容：
A类服务可部署的功能包括文生图（基础版）、商品场景图生成等；B类服务可部署的功能包括文生图（高级版）等。如专机用户购买调用次数的服务都能发到相同的集群，则该用户的所有任务都能发送到自己的专用集群上，但如专机用户购买调用次数的服务需要两套集群，则需要按两套集群的算力分别部署
例如：某用户购买 1 万次商品场景图和 1 万次文生图（基础版），只配套租用 1 张专用 GPU，是可以的，因为二者都属于
A类服务；但该用户又购买了 1 万次文生图（高级版）时，如还需使用专用算力，则必须再加新的 GPU 部署B类服务才能实现
针对专机用户，将API的服务类型做如下区分：
| 服务名称 | 服务代码 | 包含的API | 依赖的后端服务 | 单租户部署模式 |
|---|---|---|---|---|
| 抠图（基础版） | remove-background | 抠图（基础版）remove-background | 抠图基础版服务 | 一般不做单租户部署 |
| 抠图（高级版） | remove-background-pro | 抠图（高级版）remove-background-pro | 抠图高级版服务 | 一般不做单租户部署 |
| 通用图像生成（基础版） | aigc-image | 文生图（基础版）txt2img 图生图（基础版） 相似图生成 | 图像大模型服务A | A类集群 |
| 通用图像生成（高级版） | aigc-image-pro | 文生图（高级版）txt2img-pro 图生图（高级版） | 图像大模型服务B | B类服务 |
| 图像高清 | image-super-resolution | 图像高清image-super-resolution | 多个高清模型服务 | 一般不做单租户部署 |
| 商品场景图生成 | product-background | 为商品生成背景（自动版）product-background-generate-auto 把商品 P 到指定背景上 商品图换背景（更多参数版） | 图像大模型服务A + 抠图（高级版） | A类服务 |
| 模特图生成 | ai-clothing | 为模特图更换模特人物 ai-clothing-generate | 图像大模型服务A + 抠图（高级版） | A类服务 |
| 商品卖点图生成 | product-listing-image | 商品卖点图生成product-listing-image-generate | 图像大模型服务A + 抠图（高级版）+排版模型 | A类服务 |
| 广告投放图生成 | ad-image | 广告投放图生成ad-image-generate | 多个图像大模型服务+排版模型 | 一般不做单租户部署 |
| 商品海报生成 | product-poster | 商品海报生成product-poster-generate | 智能海报生成模型 | 一般不做单租户部署 |
| AIGC海报生成 | ai-poster | AIGC海报生成ai-poster-generate | 文本生成服务+多个图像大模型服务+排版模型 | 一般不做单租户部署 |
| 文本翻译和敏感检测 | prompt-preprocess | 文本翻译和敏感检测prompt-preprocess | 文本翻译和敏感检测服务 | 一般不做单租户部署 |
| 文本生成 | aigc-text | 商品卖点文案生成txt2txt-product-copywriting | 文本生成服务 | 一般不做单租户部署 |
联系方式
| 商务/销售 | 产品/售后 | |
|---|---|---|
| 电话 | 16622034570 | 18010167386 |
| 邮箱 | amin@nolibox.com | liujiashu@nolibox.com |
| 微信 | 微信号：noliboxljs |