---
name: "savePeakValleyPrice"
mode: "api"
versionRequirements:
  - { name: "@tuya-miniapp/cloud-api", version: "1.3.0" }
---

## savePeakValleyPrice

> [VERSION] @tuya-miniapp/cloud-api >= 1.3.0

> 💡 接口依赖云能力，需在[小程序开发者平台](https://platform.tuya.com/miniapp/)开发设置 - 云能力进行授权配置。

### 描述

保存设备峰谷电价配置。用于新增或修改指定设备的电价策略，修改后仅对后续新增数据生效，历史电费数据不会重新计算。

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `params` | `SavePeakValleyPriceParams` | 是 | 请求参数 |

### 返回值

类型: `Promise<boolean>`

是否保存成功

### 引用对象

##### `interface` SavePeakValleyPriceParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备 ID |
| `priceConfig` | `PeakValleyPriceConfig` | 峰谷电价配置对象 |

##### `interface` PeakValleyPriceConfig

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `normalPrice` | `string` | 常规（平段）电价，单位为货币/kWh |
| `peakValleyPrice` | `PeakValleyPrice[]` | 峰谷时段电价列表，为空数组时表示仅使用常规电价 |

##### `type` PeakValleyPrice

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `price` | `string` | 该时段电价，单位为货币/kWh |
| `startTime` | `string` | 时段开始小时，两位字符串，如 `"08"` 表示 08:00 |
| `endTime` | `string` | 时段结束小时，两位字符串，如 `"12"` 表示 12:00 |


### 示例代码

#### 请求示例

```javascript
import { savePeakValleyPrice } from '@tuya-miniapp/cloud-api';

savePeakValleyPrice({
  devId: 'vdevo123',
  priceConfig: {
    normalPrice: '0.56',
    peakValleyPrice: [
      { startTime: '08', endTime: '12', price: '0.80' },
      { startTime: '18', endTime: '22', price: '0.80' },
      { startTime: '22', endTime: '24', price: '0.30' },
    ],
  },
})
  .then(result => {
    console.log('峰谷电价保存成功:', result);
  })
  .catch(error => {
    console.error('峰谷电价保存失败:', error);
  });
```

#### 返回示例

```json
true
```


### 常见问题

#### 为什么调用云能力会出现失败的情况？

使用本接口前，请确保设备所属产品已在[涂鸦 IoT 开发平台](https://iot.tuya.com/)开启**电量统计**高级能力。未启用该能力的产品无法采集电量/电费数据，接口将返回空数据或报错。如需使用，请创建带有电量/电费统计功能的产品，并在产品详情中启用相应高级能力。同时，接口依赖云能力，需在[小程序开发者平台](https://platform.tuya.com/miniapp/)`开发设置` - `云能力`进行授权配置。