请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com?Action=CreateAIGatewayInstance&Version=2021-04-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

Query

参数名称	数据类型	是否必选	参数说明
Action	String	是	接口名称。当前 API 的名称为 `CreateAIGatewayInstance`。
Version	String	是	接口版本。当前 API 的版本为 `2021-04-01`。

Body

参数名称	数据类型	是否必选	参数说明	示例
Name	String	否	实例名称。用于在控制台和列表中识别该实例，建议使用可读且唯一的名称。	`my-maas-gateway`
InstanceType	Integer	否	实例类型。取值： `0`：maas_api（MaaS 访问加速）。	`0`
MaasAPI	Object	否	模型服务配置。包含接入的模型列表和路由策略。
Advanced	Object	否	高级配置。包含加速、缓存、限流等配置项。
Description	String	否	实例的描述信息。用于备注该实例的用途或业务场景。	`生产环境文本生成网关`
Project	String	否	实例所属的项目名称。用于按项目维度进行资源管理和权限隔离。	`default`
Tags	Object[]	否	实例的标签列表。用于对实例进行分类和筛选管理。

返回参数

参数名称	数据类型	参数说明	示例
ID	String	新创建的 AI 加速网关实例的唯一标识。后续可用于查询、更新或删除该实例。	`ga-123456789`

请求示例

POST https://open.volcengineapi.com?Action=CreateAIGatewayInstance&Version=2021-04-01
{
    "Advanced": {
        "Acceleration": {
            "Domain": "my-maas-gateway.aig.volcdngateway.com",
            "Enabled": true,
            "Error": "",
            "Modified": 1700000000,
            "Scope": "domestic",
            "Status": "Started"
        },
        "Budget": {
            "Config": {
                "CostLimit": 1000,
                "Dimension": "",
                "ModelBudgets": [
                    {
                        "CostLimit": 200,
                        "InputPrice": 0.012,
                        "Model": "doubao-seed-2-0-mini-260215",
                        "OutputPrice": 0.016,
                        "Provider": "bytedance",
                        "TokenLimit": 5000000
                    }
                ],
                "Period": {
                    "Unit": "day",
                    "Value": 1
                },
                "TokenLimit": 10000000,
                "UsageType": ""
            },
            "Enabled": true
        },
        "Cache": {
            "Config": {
                "Mode": 0,
                "TTL": 3600
            },
            "Enabled": true
        },
        "Limit": {
            "Enabled": true
        }
    },
    "Description": "生产环境文本生成网关",
    "InstanceType": 0,
    "MaasAPI": {
        "Models": [
            {
                "APIKey": "n/a",
                "BaseURL": "https://ark.cn-beijing.volces.com/api/v3",
                "Category": "Text",
                "ID": "ga-123456789",
                "Model": "doubao-seed-2-0-mini-260215",
                "Protocol": 1,
                "Provider": "bytedance",
                "Source": 0,
                "Weight": 50
            }
        ],
        "RoutePolicies": {
            "Fallback": {
                "Enabled": true
            },
            "LB": {
                "Enabled": true
            }
        }
    },
    "Name": "my-maas-gateway",
    "Project": "default",
    "Tags": [
        {
            "Key": "env",
            "Value": "production"
        }
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "CreateAIGatewayInstance",
        "Version": "2021-04-01",
        "Service": "dcdn",
        "Region": "cn-north-1"
    },
    "Result": {
        "ID": "ga-123456789"
    }
}

错误码

如果接口调用失败并返回错误信息，您可以查看公共错误码了解错误码相关信息。

最近更新时间：2026.08.19 16:30:25

这个页面对您有帮助吗？

有用

无用

全站加速

请求说明 #

调试 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #

请求说明

调试

请求参数

Query

Body

返回参数

请求示例

返回示例

错误码