面向 AI 助手:本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/create-team-seats-api.md,全部文档索引见 https://ark.volcengine.com/llms.txt。

创建企业版席位

POST https://ark.cn-beijing.volcengineapi.com/?Action=CreateTeamSeats&Version=2024-01-01

企业版管理员批量购买 Agent Plan / Coding Plan 席位(AgentPlanTeam / CodingPlanTeam)。

您通过 API 接口发起部署请求或调用本服务的,即表示您已充分阅读、理解并同意 《企业版产品和服务专用条款》、《方舟平台专用条款》、《免责声明》、《豆包模型服务协议》、《开源模型许可证》、《语音服务协议》、《Harness 能力说明和产品专用条款》 及其他适用的平台规则。如您不同意上述协议,请立即停止调用。

鉴权#

本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。

  • Access Key 鉴权,请在 Access Key 管理 页面,获取 Access Key。本接口仅支持 Access Key 鉴权。

请求参数#

Body 参数#

Plan string 必选  |  商品名称

待购买的企业版商品名称。可选值:AgentPlanTeam(Agent Plan 企业版)、CodingPlanTeam(Coding Plan 企业版)。

Seats object[] 必选  |  席位配置列表

席位配置明细列表。Plan 为 AgentPlanTeam 时最多支持 4 项配置(Small、Medium、Large、Max 各一项);Plan 为 CodingPlanTeam 时最多支持 2 项(Lite、Pro)。单次请求内不允许出现重复的 PlanType。

Duration number 必选  |  订购时长

Seats.Duration

订购时长,单位以 PricingCycle 为准。

取值范围:[1, 12]

PlanType string 必选  |  套餐档位

Seats.PlanType

套餐档位。Plan 为 AgentPlanTeam 时取值 Small、Medium、Large、Max;Plan 为 CodingPlanTeam 时取值 Lite、Pro。单次请求内不允许重复,重复时返回 Duplicated.PlanType 错误。

PricingCycle string 必选  |  计费周期

Seats.PricingCycle

计费周期。当前仅支持 Month(包月)。

SeatNumber number 必选  |  席位数量

Seats.SeatNumber

该档位创建的席位数量,需大于 0。企业版首次购买需满足:账号下处于 Active 状态的席位数加本次新购总数不少于 5 个。

最小值:1

AutoRenew boolean 默认值 false  |  自动续费

Seats.AutoRenew

是否在套餐到期时开启自动续费。设为 true 时套餐到期前会从云账户余额自动续费,仅支持单次自动续费。

DryRun boolean  |  预检模式

是否仅做参数预检而不实际下单。设为 true 时仅完成参数、额度全链路校验,不占用席位且不执行扣款,适用于上线前的预校验场景。

ProjectName string 默认值 default  |  项目名称

席位所属的项目空间名称。未传值时使用默认项目;指定不存在的项目时返回 NotFound.ProjectName 错误。

响应参数#

Seats object[]  |  席位结果列表

已分配的席位结果列表,按 PlanType 聚合返回;同档位下生成的所有席位 ID 通过 SeatIds 数组返回。

PlanType string  |  套餐档位

Seats.PlanType

该结果项对应的套餐档位。

SeatIds string[]  |  席位 ID 列表

Seats.SeatIds

该档位下已生成的席位 ID 列表,列表长度等于该档位的 SeatNumber,可作为后续席位绑定、续费、终止接口的入参。