资讯 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

购买算力单元

功能介绍

本接口用于购买算力单元。

权限说明

调用本文API,需符合以下权限要求,权限介绍及分配,请查看角色与权限控制列表账号创建与权限分配。需具有以下任一权限:

  • 完全控制千帆大模型平台的权限:QianfanFullControlAccessPolicy
  • 运维操作千帆大模型平台预测服务的权限:QianfanServiceOperateAccessPolicy

鉴权说明

调用本文API,使用“基于安全认证AK/SK”进行签名计算鉴权,即使用安全认证中的Access Key ID 和 Secret Access Key进行鉴权,具体鉴权认证机制参考HTTP调用鉴权说明

请求结构

POST /v2/computeunit?Action=PurchaseComputeUnit HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json

{
   "computeUnitCount": 1,
    "billing": {
        "paymentTiming": "Postpaid",
        "releaseTime": "2024-12-29 00:30:42"
    },
    "computeUnitConfig": {
        "region": "bj",
        "type": "gpu-1"
    }
}

请求头域

除公共头域外,无其它特殊头域。

请求参数

  • Query参数
名称 类型 必填 描述
Action string 方法名称,固定值PurchaseComputeUnit
  • Body参数
名称 类型 必填 描述
billing Billing 订单、计费相关参数
computeUnitConfig object 算力单元配置
computeUnitCount int 算力单元数

Billing说明

名称 类型 必填 描述
paymentTiming string 付费类型,可选值如下:
· Prepaid:表示预付费
· Postpaid:表示后付费
reservation Reservation 保留信息,说明:
(1)只有当付费类型为预付费,即paymentTiming值为Prepaid时,该字段必填
(2)付费类型为后付费,无需填写此参数
releaseTime string 定时释放时间,说明:
(1)只有当付费类型为后付费,即paymentTiming值为Postpaid时,该字段有效
(2)支持RFC3339格式和标准格式,如2020-01-25T12:30:30+08:002020-01-25 12:30:30

Reservation说明

名称 类型 必填 描述
reservationTimeUnit string 时间单位,可选值如下:
· Month:月
reservationLength int 购买时长,说明:时间单位为月,取值范围 [1-12]
autoRenew boolean 是否自动续费,可选值如下:
· true:是
· false:否,默认值为false
autoRenewTimeUnit String 自动续费周期时间单位,默认值为Month,可选值如下:
· Month:月
autoRenewTime int 自动续费时长,说明:
(1)单位:月
(2)默认值为1,取值范围:[1,6]

computeUnitConfig说明

名称 类型 必填 描述
region string 资源地域,说明:
(1)如果填写该字段,可选值如下:
· bj:北京
· bd:保定
type string 资源类型,可选值如下:
· CPU:cpu
· 加速卡I型:gpu-1
· 加速卡Ⅱ型:gpu-2
· 加速卡Ⅲ型:gpu-3
· 加速卡Ⅳ型:gpu-4
· 加速卡Ⅴ型:gpu-5
· 加速卡Ⅵ型:gpu-6

响应头域

除公共头域外,无其它特殊头域。

响应参数

名称 类型 描述
requestId string 请求ID
result object 请求结果

result说明

名称 类型 描述
instanceId string 实例ID
orderId string 订单ID

请求示例

curl --location 'https://qianfan.baidubce.com/v2/computeunit?Action=PurchaseComputeUnit' \
--header 'Authorization: bce-auth-v1/f0ee7a166xxxxa8079702c13/2023-09-19T13:42:13Z/180000/host;x-bce-date/9a8cfb8ee58a8xxxxxxxe374525543' \
--header 'Content-Type: application/json' \
--data '{
    "computeUnitCount": 1,
    "billing": {
        "paymentTiming": "Postpaid",
        "releaseTime": "2024-12-29 00:30:42"
    },
    "computeUnitConfig": {
        "region": "bj",
        "type": "gpu-1"
    }
}'

响应示例

{
    "requestId":"1bef3f87-c5b2-4419-936b-50f9884f10d4",
    "result":{
        "instanceId":"44961088fxxxx9e9379f5daf",
        "orderId":"7b468732xxxxxb8364292"
    }
}

错误码

若请求错误,服务器将返回的JSON文本包含以下参数:

名称 描述
requestId 请求ID
code 错误码
message 错误描述信息,帮助理解和解决发生的错误

例如错误返回:

{
    "requestId":"6ba7b810-xxxc04fd430c8",
    "code":"AccessDenied",
    "message":"Access denied."
}

更多其他错误码,也可以查看错误码说明

上一篇
修改算力单元后付费自动释放时间
下一篇
查询算力单元列表