图像编辑 - 人脸融合（CvuNet） - AIGC SaaS API 平台 - 专注 Stable Diffusion，LangChain 知识库等 AIGC SaaS API 能力建设

> 本模型来在 ModelScope：https://modelscope.cn/models/damo/cv_unet-image-face-fusion_damo/summary，由第三方开发者托管到 AIGCaaS 平台

# 模型基本信息

给定一张模板图和一张目标用户图，图像人脸融合模型能够自动地将用户图中的人脸融合到模板人脸图像中，生成一张与目标人脸相似，且具有模版图外貌特征的新图像。

其生成效果如下所示：

![生成效果](https://www.images.wiki/SrtD65lwZwfZfGj6FgiB.png)

### 模型局限性以及可能的偏差

- 建议图像中人脸五官区域轮廓完整，无明显遮挡，否则可能影响人脸检测结果导致融合效果不佳。
- 算法支持人脸偏侧一定角度，在偏侧角度不超过30度的情况下能取得更佳效果。
- 图像中人脸尺寸建议大于64×64像素，人脸区域建议不大于全图区域的2/3，否则会影响人脸检测的结果导致无法进行融合操作。
- 如果两张人脸的脸型差别过大，可能影响脸部边缘区域的融合效果。

# 接口

请求地址：`https://api.aigcaas.cn/v3/application/image_edit/action/cvunet`

请求方式：`POST`

请求类型：同步请求

参数列表：

| 参数名               | 类型   | 位置   | 解释                                                         |
| -------------------- | ------ | ------ | ------------------------------------------------------------ |
| Nonce                | string | header | **防重放配置** 随机字符串（最大长度20位）且10秒内不可重复    |
| Timestamp            | string | header | **发起请求时间戳** 与服务器时间差遭遇10秒                    |
| SecretID             | string | header | **密钥信息** 密钥配置中的 secret_id 配置                     |
| Token                | string | header | **签名结果** sha256(Timestamp, SecretKey, Nonce)             |
| user_path_base64     | string | body   | **即将融合头像图片Base64** 图片Base64 后的编码，不需要包括图片描述信息，例如“data:image/png;base64”（与user_path_url参数二选一） |
| user_path_url        | string | body   | **即将融合头像图片地址** 图片地址，指的是图片的具体网址（与user_path_base64 参数二选一） |
| template_path_base64 | string | body   | **原图图片Base64** 图片Base64 后的编码，不需要包括图片描述信息，例如“data:image/png;base64”（与template_path_url参数二选一） |
| template_path_url    | string | body   | **原图图片地址** 图片地址，指的是图片的具体网址（与template_path_base64 参数二选一） |

# 案例代码

## Python

```python
import time
import json
import hashlib
import random
import requests

# 签名对象
getSha256 = lambda content: hashlib.sha256(content.encode("utf-8")).hexdigest()

secret_id = '{请替换为自己的密钥信息: SecretId}'  # 密钥信息
secret_key = '{请替换为自己的密钥信息: SecretKey}'  # 密钥信息

# 请求地址
url = "https://api.aigcaas.cn/v3/application/image_edit/action/cvunet"
# 构建请求头
nonce = str(random.randint(1, 10000))
timestamp = str(int(time.time()))
token = getSha256(("%s%s%s" % (timestamp, secret_key, nonce)))
headers = {
    'SecretID': secret_id,
    'Nonce': nonce,
    'Token': token,
    'Timestamp': timestamp,
    'Content-Type': 'application/json'
}

# 构建请求 body，可以自行根据上面的内容，添加更多参数
data = {
    "user_path_base64": "{图片链接}",
    "template_path_base64": "{图片链接}"
}

# 获取响应
response = requests.request("POST", url, headers=headers, data=json.dumps(data))
print(response.text)
```

## Node.JS

```javascript
const axios = require('axios');
const crypto = require('crypto');

const secret_id = '{请替换为自己的密钥信息: SecretId}'  // 密钥信息
const secret_key = '{请替换为自己的密钥信息: SecretKey}'  // 密钥信息

// 请求地址
const url = `https://api.aigcaas.cn/v3/application/image_edit/action/cvunet`

// 构建请求头
const timestamp = Math.round(new Date() / 1000);
const nonce = 10000 + Math.round(Math.random() * 90000);
const hash = crypto.createHash('sha256');
hash.update(`${timestamp}${secret_key}${nonce}`);
const token = hash.digest('hex');
const headers = {
    'SecretID': secret_id,
    'Nonce': nonce,
    'Token': token,
    'Timestamp': timestamp,
    'Content-Type': 'application/json',
}

// 构建请求 body，可以自行根据上面的内容，添加更多参数
const data = {
    "image_url": "{图片链接}",
    "template_path_base64": "{图片链接}"
};

// 获取响应
axios({
    method: 'post',
    url: url,
    headers: headers,
    data : JSON.stringify(data),
})
.then(function (response) {
    console.log(JSON.stringify(response.data));
})
.catch(function (error) {
    console.log(error);
});
```

## Golang

```go
package main

import (
    "time"
    "fmt"
    "strings"
    "net/http"
    "io/ioutil"
    "math/rand"
    "strconv"
    "crypto/sha256"
    "encoding/hex"
    "reflect"
)

func main() {

secret_id := "{请替换为自己的密钥信息: SecretId}" // 密钥信息
  	secret_key := "{请替换为自己的密钥信息: SecretKey}" // 密钥信息

// 构建请求 body，可以自行根据上面的内容，添加更多参数
    url := strings.NewReader("https://api.aigcaas.cn/v3/application/image_edit/action/cvunet")
    method := "POST"
    payload := strings.NewReader(`{"image_url": "{图片链接}", "template_path_base64": "{图片链接}"}`)
    timestamp := int64(time.Now().Unix())
    rand.Seed(time.Now().UnixNano())
    nonce := rand.Intn(10000)
    sign := strconv.FormatInt(timestamp, 10) + secret_key + strconv.Itoa(nonce)
    hash := sha256.New()
    hash.Write([]byte(sign))
    token := hex.EncodeToString(hash.Sum(nil))

client := &http.Client{}

req, err := http.NewRequest(method, url, payload)
    if err != nil {
        fmt.Println(err)
        return
    }
    req.Header.Add("SecretID", secret_id)
    req.Header.Add("Nonce", strconv.Itoa(nonce))
    req.Header.Add("Token", token)
    req.Header.Add("Timestamp", strconv.FormatInt(timestamp, 10))
    req.Header.Add("Content-Type", "application/json")

// 发起请求
    res, err := client.Do(req)
    if err != nil {
        fmt.Println(err)
        return
    }
    defer res.Body.Close()

body, err := ioutil.ReadAll(res.Body)
    if err != nil {
      fmt.Println(err)
      return
    }
    fmt.Println(string(body))
```

## PHP

```php
<?php

$curl = curl_init();

$secret_id = '{请替换为自己的密钥信息: SecretId}';  // 密钥信息
$secret_key = '{请替换为自己的密钥信息: SecretKey}';  // 密钥信息

// 请求地址
$url = 'https://api.aigcaas.cn/v3/application/image_edit/action/cvunet';

// 构建请求头
$nonce = strval(rand(1, 100000));
$timestamp = strval(time());
$token = hash("sha256", utf8_encode($timestamp.$secret_key.$nonce));

// 构建请求 body，可以自行根据上面的内容，添加更多参数
$body = '{"image_url": "{图片链接}", "template_path_base64": "{图片链接}"}';

// 发起请求
curl_setopt_array($curl, array(
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>$body,
  CURLOPT_HTTPHEADER => array(
    'SecretID: '.$secret_id,
    'Nonce: '.$nonce,
    'Token: '.$token,
    'Timestamp: '.$timestamp,
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
```

最佳实践

基于当前接口的最佳实践案例，可以帮助您快速了解并上手当前接口

温馨提示：我们一直在收集针对不同接口的最佳实践案例，如果您有基于当前接口实现某些功能，解决某些问题的实践案例，欢迎投稿给我们，一经审核通过将会为您赠送 50 元京东购物券，或 AIGCaaS 平台 100000 金币（约等于100元），投稿邮箱 s@xmail.tech，或联系微信 cloudenv

基础信息

接口价格

15.0金币(0.015元)/次

按照调用次数计费

最佳实践

关于 AIGCaaS

导航

应用与接口

平台协议

联系我们