# API-Final

**Repository Path**: bunnyyang73/api-final

## Basic Information

- **Project Name**: API-Final
- **Description**: api期末项目
- **Primary Language**: Python
- **License**: MulanPSL-1.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2021-01-19
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# api

 **文档名称**  |  **truly beautiful—— 图像增强软件** 
-|-
 **产品名称**  | **[本美](https://modao.cc/app/0a8deee1fc12a157780cd7bf95631c44c72b80e2?simulator_type=device&sticky)** 
 **产品描述**  |  **一款增强图片视觉效果，修复图片，还原原美的app。** 
 **文档作者**  |  **杨文山 1910130008** 


## 一.价值主张

### （一）价值主张宣言

* 现如今科学技术的发展带动了拍摄、摄影技术硬件的发展，手机、照相机等拍摄工具越来越凸显普遍化、便利化，在拍摄门槛日益降低的大环境下，对摄影作品的要求相反的呈不断升高的趋势。所以，人们对所拍摄作品的要求越来越高，许多拍摄者对图片整体化、一体化的要求越来越高，所以，我的产品使用百度API开放平台中的照片增强功能，对质量欠佳的图片进行图片增强。


### （二）核心价值

1、提升网站图片、手机相册图片、视频封面图片的质量，解决图像偏小、不清晰、被拉伸、过暗或过亮等问题

2、调整过暗或者过亮图像的对比度，使图像更加鲜明

3、对压缩后的模糊图像实现智能快速去噪，优化图像纹理细节，使画面更加自然清晰

4、可智能调节图片的色彩饱和度、亮度、对比度，使得图片内容细节、色彩更加逼真




## 二、问题描述与需求列表




### （一）用户问题表述

* 随着科学技术的发展，AI识别技术越来越完善，其中照片美化，照片修复的需求越来越大，在通过使用百度图片增强等的AI技术后，“本美”App轻松地解决了以上诉求。

* 在市场上还没有相似的专门集合了图片增强功能的软件，用户需要这样一款软件，想及时修复图片，还原图片本美的时候，因为没有简单快捷的软件，而无法及时解决问题。


### (二) 需求列表
| 标题     | 用户使用场景                 | 重要程度 |
|--------|------------------------|------|
| 图像对比度增强 | 图像对比度不足，图片重点不突出    | 重要   |
| 图片修复   | 老照片、图片质量损坏照片急需修复 | 很重要   |
| 图像色彩增强   | 图片黯淡，欠缺生动 | 重要   |

## 解决方案原型表述
1.打开“本美”app

2.点击注册账号，如有账号即登陆。

3.选择三个功能：图像对比度增强，图片修复，图像色彩增强之一，点击进入操作。


## 用户对象 目标用户群：各个领域喜欢摄影、或对照片提升质量有需求的人士

## 用户画像

| 1.小杨  | 有很多家里传下来的老图片，但其画面不堪入目，想要修复  |
|---|---|
| 2.小曾  | 设计师，每日手上都有很多照片需要美化制作，想要一款app解决这些重复性工作  |

## 三、解决方案：界面流程与关键智能交互

1.登陆界面，输入用户名和密码即登陆

![输入图片说明](https://gitee.com/bunnyyang73/api-final/raw/master/%E5%8E%9F%E5%9E%8B%E5%9B%BE/11.png "在这里输入图片标题")

2.注册页面

![输入图片说明](https://gitee.com/bunnyyang73/api-final/raw/master/%E5%8E%9F%E5%9E%8B%E5%9B%BE/22.png "在这里输入图片标题")

3.主界面

![输入图片说明](https://gitee.com/bunnyyang73/api-final/raw/master/%E5%8E%9F%E5%9E%8B%E5%9B%BE/33.png "在这里输入图片标题")

4.各功能界面

![输入图片说明](https://gitee.com/bunnyyang73/api-final/raw/master/%E5%8E%9F%E5%9E%8B%E5%9B%BE/44.png "在这里输入图片标题")


5.上传图片


![输入图片说明](https://gitee.com/bunnyyang73/api-final/raw/master/%E5%8E%9F%E5%9E%8B%E5%9B%BE/55.png "在这里输入图片标题")

6.得到结果，保存图片

![输入图片说明](https://gitee.com/bunnyyang73/api-final/raw/master/%E5%8E%9F%E5%9E%8B%E5%9B%BE/66.png "在这里输入图片标题")


## 四、可行性分析
* 用户可欲性：产品设计符合用户日常使用app的习惯，界面简单，导向清晰。对于用户来说简单易上手，便于操作，技术要求低。
* 技术可行性：市面上有类似美图软件，可以参考各类软件的优缺点，并集大成。有前者经验进行借鉴，减少技术开发上的困难。
* 商业可行性：市场上相似的产品目前较少，市场需求空缺较大，暂未出现行业领头产品。对手竞品的功能单一，综合性功能较少，本产品有竞争优势。


## 五、[原型产品链接](https://modao.cc/app/0a8deee1fc12a157780cd7bf95631c44c72b80e2?simulator_type=device&sticky)

## 六、解决方案：数据流程及关键智能API使用 

### （一）流程图

#### 1、用户界面流程图

![界面流程图](https://gitee.com/bunnyyang73/api-final/raw/master/%E5%8E%9F%E5%9E%8B%E5%9B%BE/1.png)
![输入图片说明](https://gitee.com/bunnyyang73/api-final/raw/master/%E5%8E%9F%E5%9E%8B%E5%9B%BE/2.jpg "在这里输入图片标题")




### (二)智能API使用水平


1.API代码测试
图像对比度增强
![](https://gitee.com/bunnyyang73/api-final/raw/master/%E5%8E%9F%E5%9E%8B%E5%9B%BE/db.png)
图片修复
![](https://gitee.com/bunnyyang73/api-final/raw/master/%E5%8E%9F%E5%9E%8B%E5%9B%BE/xf.png)
图像色彩增强 
![](https://gitee.com/bunnyyang73/api-final/raw/master/%E5%8E%9F%E5%9E%8B%E5%9B%BE/sc.png)
----
2.代码示例
```python
# encoding:utf-8

import requests
import base64

'''
图像清晰度增强
'''

request_url = "https://aip.baidubce.com/rest/2.0/image-process/v1/image_definition_enhance"
# 二进制方式打开图片文件
f = open('[本地文件]', 'rb')
img = base64.b64encode(f.read())

params = {"image":img}
access_token = '[调用鉴权接口获取的token]'
request_url = request_url + "?access_token=" + access_token
headers = {'content-type': 'application/x-www-form-urlencoded'}
response = requests.post(request_url, data=params, headers=headers)
if response:
    print (response.json())
```
```python
{
     "log_id":739539874,
     "image":base64str
}
```
---
 3.百度智能云图像增强文档技术要求
**** 
 4.接口描述： **该请求用于图像增强。即对于输入的一张图片（可正常解码，且长宽比适宜），可智能调节图片的色彩饱和度、亮度、对比度，使得图片内容细节、色彩更加逼真。** 
 ----
5.请求说明：
* 请求示例：HTTP 方法：POST
请求URL： https://aip.baidubce.com/rest/2.0/image-process/v1/contrast_enhance
          https://aip.baidubce.com/rest/2.0/image-process/v1/inpainting
          https://aip.baidubce.com/rest/2.0/image-process/v1/image_definition_enhance
URL参数：

| 参数         | 值                                                                         |
|--------------|---------------------------------------------------------------------------|
| access_token | 通过API Key和Secret Key获取的access_token,参考“[Access Token获取](https://ai.baidu.com/ai-doc/REFERENCE/Ck3dwjhhu)” |
* Header如下：

| 参数           | 值                                 |
|--------------|-----------------------------------|
| Content-Type | application/x-www-form-urlencoded |
---
6.API使用后风险报告
** 需要处理的图片base64编码后大小不超过4M，最短边至少64px，最长边最大4096px，长宽比3：1以内，像素乘积不超过 1280*720。注意：图片的base64编码是不包含图片头的，如（data:image/jpg;base64,）** 
 
**总结** ：百度智能云图像增强API还在不断更新，基于百度海量数据和算法积累，并基于业务场景应用反馈快速迭代，持续优化，提供业界领先的图像处理效果。提供稳定易用的云端API及多种SDK使用方式，可基于Demo快速简单开发，充分满足不同场景下、多种终端接入需求。但同时，它仍有瑕疵所在，即对一些色彩丰富复杂的图片处理困难、黑白图片处理不当等问题。

* 使用价格
每日500次免费调用额度，免费额度用尽后开始计费，价格如下：

| 月调用量（万次）     | 图像增强（元/千次） |
|--------------|------------|
| 0<月调用量<=5    | 0.70       |
| 5<月调用量<=10   | 0.60       |
| 10<月调用量<=20  | 0.50       |
| 20<月调用量<=50  | 0.40       |
| 50<月调用量<=100 | 0.35       |
| 100<月调用量     | 0.3        |


> 说明： 调用失败不计费




## 3、API平台对比
1.  [**阿里云视觉智能开放平台
**](https://help.aliyun.com/product/142958.html?spm=a2c4g.11186623.6.540.74b36d06TmxYsQ) ：阿里云视觉智能开放平台（https://vision.aliyun.com）是基于阿里巴巴视觉智能技术实践经验，面向视觉智能技术企业和开发商（含开发者），为其提供高易用、普惠的视觉API服务，帮助企业快速建立视觉智能技术的应用能力的综合性视觉AI能力平台。免费的调用量为500次/天，但是并发数不保证；付费版调用数无限制，并发数为10qps，大约0.3元可以调用一千次，调用量越多，收费越便宜，这对于不同开发者来说可以各取所需，比较方便。
2.  [**腾讯云图像分析**](https://cloud.tencent.com/product/tiia) ：腾讯云图像分析基于深度学习等人工智能技术和海量训练数据，提供综合性的图像智能服务，包含图像理解（解析图像中的场景、物品、人物、动物等）、图像处理（对图像进行裁剪、美化）、图像质量评估（分析图像视觉质量）等。图像分析所使用的算法，广泛应用于腾讯内部各个产品，应用场景包含相册、信息流、社交、广告等，每天分析、处理海量图片，可以大幅提升各类产品的体验、效率。但其返回参数仅有卡路里和名字，返回信息与百度相比较少，以及仅支持50次免费试用，10元可以调用1000次，价格和百度对比相对较贵，所以这对于一些个人/学生开发者来说并不十分友好。


##### （1）智能加值

* 百度AI有关图像技术方面的开放api更加丰富，可供选择较多:
 
* [红酒识别](https://ai.baidu.com/tech/imagerecognition/redwine)
* [货币识别](https://ai.baidu.com/tech/imagerecognition/currency)
* [地标识别](https://ai.baidu.com/tech/imagerecognition/landmark)
* [动物识别](https://ai.baidu.com/tech/imagerecognition/animal)

* 京东AI在图像技术方面开放API较少，缺少对图像AI的大类区分，热门、有趣、更具有市场前景的API接口较少：

* [通用图片搜索](http://neuhub.jd.com/ai/api/image/index)
* [车辆识别](http://neuhub.jd.com/ai/api/ocr/ocr-for-vehicle-license-plate)
* [垃圾分类](http://neuhub.jd.com/ai/api/image/garbageClassify)
* [犬类识别](http://neuhub.jd.com/ai/api/image/Dog_Classification)
***
## 七、学习/实践心得总结及感谢

* 在本次项目实践中，我学习了如何系统性的制作一份架构完善的产品需求文档。文档撰写参考了18级师兄的作品、19级同学的耐心指导，从中学习作品结构以及文档结构，在此表示由衷的感谢。
* 本次项目中实现了百度API、京东AI的调用，同时学习到作为产品经理以顾客为中心的产品开发思路。
* 首先最重要的是寻找不同的api之间的关联，然后通过之间的共通点去找寻自己想要开发产品的特点，根据特点满足用户需求，用户至上始终是产品的第一要点。
* 在项目的设计中，我也学习到一个好的产品不仅仅只是需要完善的功能，以用户为中心的界面设计以及配色风格同样对产品产生很大影响。

#### 感谢：

在此非常感谢提供项目参考的同学，以下为参考的作品url：
* [姚卓凡同学](https://gitee.com/yiudaisin/api)

同时非常感谢百度ai提供的免费资源调用，以及提供的技术支持与技术文档：
* [Access Token获取](https://ai.baidu.com/ai-doc/REFERENCE/Ck3dwjhhu)
* [图像增强](https://cloud.baidu.com/doc/IMAGEPROCESS/s/ek3bclnzn)
* [ProcessOn](https://www.processon.com/diagrams)

此外，对“墨刀”在线产品原型设计与协作平台表示感谢，为项目产品原型制作提供技术性支持：
* [“墨刀”在线产品原型设计与协作平台](https://modao.cc/)



***

------
有效外链：28个
自制图片：5张