All Products
Search
Document Center

PolarDB:CreateAIDBClusterTask

Last Updated:Jul 09, 2026

Creates a model creation operator instance.

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

RegionId

string

No

The region ID.

cn-beijing

DBClusterId

string

Yes

The cluster ID.

pc-****************

ModelSource

string

Yes

The model source. Valid values:

  • public: preset model

  • custom: custom model

public

ModelType

string

No

The custom model type.

qwen3

ModelName

string

Yes

The model name.

  • For a preset model, specify the name of the selected model.

  • For a custom model, specify the path where the model is stored (the model trained in a cold storage instance).

Qwen3-8B

DatasetPath

string

No

The training dataset ID. This parameter is required for fine-tuning.

pds-2zetrain***

EvalDatasetPath

string

No

The validation dataset ID. This parameter is required for evaluation.

pds-2zetrain***

RunningParameter

string

Yes

The running parameters in JSON string format.

{"split_dataset_ratio": 0.1,"train_mode": "grpo","train_type": "lora","num_epochs": 1,"batch_size": 2,"eval_batch_size": 2, "num_generations": 2, "learning_rate": "1e-6", "data_file_list": "test-00000-of-00001.jsonl#1000", "lora_rank": 8, "lora_alpha": 32, "external_plugins": "/plugin/train/plugin.py", "reward_funcs": "format,external_countdown", "gpu_memory_utilization": 0.4}

KubeType

string

Yes

The model service type. Valid values:

  • aitrain: model operator tuning

Valid values:

  • aitrain :

    aitrain

aitrain

TaskName

string

No

The description of the model service.

xxxx

ZoneId

string

No

The zone ID.

cn-hangzhou-k

VPCId

string

No

The virtual private cloud (VPC) ID.

vpc-*******************

VSwitchId

string

No

The vSwitch ID.

vsw-*********************

SecurityGroupId

string

No

The security group ID.

sg-bp**************

DBInstanceClass

string

No

The instance type.

polar.pg.g6.4xlarge.guh

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

Id of the request

CED079B7-A408-41A1-BFF1-EC608E******

OrderId

string

The order ID.

2035638*******

DBClusterId

string

The instance ID of the generated model service.

pm-2zo88***

Examples

Success response

JSON format

{
  "RequestId": "CED079B7-A408-41A1-BFF1-EC608E******",
  "OrderId": "2035638*******",
  "DBClusterId": "pm-2zo88***"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.