All Products
Search
Document Center

Cloud Phone:CreateAICloudPhone

Last Updated:Jul 24, 2026

Creates an AI cloud phone.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

Amount

integer

Yes

The quantity to purchase.

1

BandwidthPackageId

string

Yes

The bandwidth package ID.

np-791ncq8qcuoopxxxx

BizRegionId

string

Yes

The region ID for the purchase.

cn-shanghai

ImageId

string

Yes

The image ID.

imgc-0aae4rxwoktvr851h

InstanceGroupName

string

Yes

The instance group name.

test1

InstanceGroupSpec

string

Yes

The instance group specification. Valid values:

  • STANDARD: standard.

  • MEDIUM: advanced.

MEDIUM

Period

integer

Yes

The purchase duration.

1

PeriodUnit

string

Yes

The unit of the purchase duration.

Month

PolicyGroupId

string

No

The policy group ID.

pg-0bjrh3oxk2q0xxxxx

PromotionId

string

No

The coupon ID.

youhuiquan_promotion_xxx

AutoPay

boolean

No

Specifies whether to enable automatic payment.

true

Response elements

Element

Type

Description

Example

object

PlainResult

RequestId

string

The request ID.

9A51B1DF-96FF-3BCC-B08C-783161D3****

Data

object

The response data object.

OrderId

integer

The order ID.

20230930123456

PackageIds

array

The list of package IDs. After the payment is successful, instances are created based on these IDs through a callback.

string

The package ID.

cmag-0m9ssif25165mxxxx

Examples

Success response

JSON format

{
  "RequestId": "9A51B1DF-96FF-3BCC-B08C-783161D3****",
  "Data": {
    "OrderId": 20230930123456,
    "PackageIds": [
      "cmag-0m9ssif25165mxxxx"
    ]
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.