bind-seat

Qianfan Baidu

  • Get started
    • Quick Start
    • Model List
    • Price
    • How to Obtain Token Length
  • Capabilities
    • Text Generation
    • Deep Thinking
    • Visual Understanding
  • Features
    • Structured Output
    • Function calling
    • Dialogue Prefix Continuation
    • Usage Statistics Guide
  • API Reference
    • models
      • text-generation
    • management
      • POSTpurchase-seat
      • POSTrenew-seat
      • POSTupgrade-seat-plan
      • POSTdescribe-seat-list
      • POSTdescribe-seats
      • POSTcreate-member-and-bind-seat
      • POSTlist-members
      • POSTbind-seat
      • POSTunbind-seat
      • POSTreset-member-api-key
      • POSTdescribe-member-api-key
      • POSTdescribe-seat-usage-detail
      • POSTdescribe-support-models
  • User Agreement for Baidu Qianfan Large Model Service and Agent Development Platform
All documents
menu
No results found, please re-enter

Qianfan Baidu

  • Get started
    • Quick Start
    • Model List
    • Price
    • How to Obtain Token Length
  • Capabilities
    • Text Generation
    • Deep Thinking
    • Visual Understanding
  • Features
    • Structured Output
    • Function calling
    • Dialogue Prefix Continuation
    • Usage Statistics Guide
  • API Reference
    • models
      • text-generation
    • management
      • POSTpurchase-seat
      • POSTrenew-seat
      • POSTupgrade-seat-plan
      • POSTdescribe-seat-list
      • POSTdescribe-seats
      • POSTcreate-member-and-bind-seat
      • POSTlist-members
      • POSTbind-seat
      • POSTunbind-seat
      • POSTreset-member-api-key
      • POSTdescribe-member-api-key
      • POSTdescribe-seat-usage-detail
      • POSTdescribe-support-models
  • User Agreement for Baidu Qianfan Large Model Service and Agent Development Platform
  • Document center
  • arrow
  • QianfanBaidu
  • arrow
  • 4.API Reference
  • arrow
  • management
  • arrow
  • bind-seat
Table of contents on this page
  • Authentication
  • Request Parameters
  • Sample Code
  • Response
  • Error Codes

bind-seat

Updated at：2026-08-24
POST
https://api.baiduqianfan.ai/v2/overseas/team/tokenplan?Action=BindSeat

Call this API to bind seats to specified members in batches.

Authentication

This API requires API Key authentication. Log in to the Baidu AI Cloud Console to obtain your API Key:

  • If you already have an API Key, click Show in the API Key column and copy it.
  • If you have not created an API Key yet, click Create API Key. After it is created, click Show in the API Key column and copy it.

Keep your API Key secure. Do not share it publicly or commit it to code repositories.

Request Parameters

Headers
No additional special headers except common headers
Body
memberSeatBindInfo array

The list of seat-member binding pairs.

Required
Show Sub-properties Hide Sub-properties
items object {2}
Show Sub-properties Hide Sub-properties
seatId string

The seat ID. Duplicate seat IDs are not allowed within the same request; otherwise TokenPlanParamDuplicated is returned. If the seat is not in an operable state (deactivated, expired, or modified by a concurrent operation), TokenPlanSeatNotAvailable is returned.

Required
cloudId string

The cloudId of the member's sub-account to bind. It can be obtained via the Create Member and Bind Seat API or the List Members API.

Required
Request Structure
POST /v2/overseas/team/tokenplan?Action=BindSeat HTTP/1.1
Host: api.baiduqianfan.ai
Authorization: Bearer <API Key>
Content-Type: application/json

{
  "memberSeatBindInfo": [
    {
      "seatId": "tpst-w25ysj7mghkt",
      "cloudId": "a60ba3c706214bf4bbe95ad0dd9768e7"
    }
  ]
}

Sample Code

请求示例
curl -X POST 'https://api.baiduqianfan.ai/v2/overseas/team/tokenplan?Action=BindSeat' \
 -H 'Content-Type: application/json' \
 -H 'Authorization: Bearer <API Key>' \
 -d '{
  "memberSeatBindInfo": [
    {
      "seatId": "tpst-w25ysj7mghkt",
      "cloudId": "a60ba3c706214bf4bbe95ad0dd9768e7"
    }
  ]
}'

Response

Headers
No additional special headers except common headers
Response Parameters
requestId string

The request ID in UUID format, used for troubleshooting.

Optional
result object

The business data object. An empty object {} when the binding succeeds.

Optional
Show Sub-properties Hide Sub-properties
响应示例
{
  "requestId": "e424ae2b-ff67-4740-98ce-7d096a797809",
  "result": {}
}

Error Codes

If a request fails, the server will return a JSON object with a code field identifying the error.

Common Error Codes for This API

Error Code Description
ParamError Failed to parse or validate request parameters.
ParamValueError Invalid parameter value.
TokenPlanParamDuplicated Duplicate seatId within the same batch.
TokenPlanSeatNotFound The seat does not exist.
TokenPlanSeatNotAvailable The seat is not in an operable state (deactivated, expired, or modified by a concurrent operation).

Complete Error Code Reference

The table below lists all possible values of the code field returned by TokenPlan APIs. The common error codes of each API are a subset of this list.

Error Code HTTP Status Code Description
ParamError 400 Failed to parse or validate request parameters.
ParamValueError 400 Invalid parameter value.
RateLimitExceeded 429 Too many concurrent requests; rate limiting triggered.
TokenPlanSeatNotFound 400 The seat does not exist.
TokenPlanSeatNoPermission 400 No permission to operate on this seat.
TokenPlanSeatNotAvailable 400 The seat is not in an operable state (deactivated, expired, or modified by a concurrent operation).
TokenPlanSeatMemberMismatch 400 The member bound to the seat does not match the request.
TokenPlanMemberNotFound 400 The member does not exist.
TokenPlanMemberNoPermission 400 No permission to operate on this member.
TokenPlanParamDuplicated 400 The request contains duplicate items (e.g., seatId).
TokenPlanApiKeyRespError 500 The API Key service returned an error.
TokenPlanApiKeyRespNull 500 The API Key service returned an empty response.
TokenPlanApiKeyIsEmpty 500 The API Key is an empty string.
TokenPlanMemberListError 500 An error occurred while querying the member list.
TokenPlanIamQuerySubusersWithContactError 500 An error occurred while querying sub-user information from IAM.
TokenPlanResourceNotFound 400 The plan resource does not exist.
TokenPlanResourceAlreadyExists 400 The plan resource already exists and cannot be purchased again.
TokenPlanResourceNotAvailable 400 The plan resource has been unsubscribed or has expired and cannot be operated on.
TokenPlanSeatPlanMismatch 400 The seat's plan type does not match the request.
TokenPlanSeatPlanNotUpgradable 400 The seat's plan type does not support upgrades.
TokenPlanLogNoAction 400 Unsupported log action.
TokenPlanLogParseTimeError 500 An error occurred while parsing the log time.
TokenPlanLimitAdminError 500 The limitServer service encountered an error.
TokenPlanMysqlMemberError 500 An error occurred while querying member data.
TokenPlanDomainHasActivePlan 400 The master account already has an active plan and cannot purchase another one.
TokenPlanMemberAlreadyBound 400 The member is already bound to a seat under the current plan and cannot be bound again.
TokenPlanSeatResourceMismatch 400 Seats bound in the same batch must belong to the same plan.
TokenPlanChooseAndBindError 500 An error occurred while adding a member from an existing sub-user.
TokenPlanCreateAndBindError 400 An error occurred while creating the sub-user or adding the member.

Previous
list-members
Next
unbind-seat