---
title: create_input
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendgraphapi/atlasgeapi_07_0766.html
sourcePath: /source/zh/canncommercial/900/API/ascendgraphapi/atlasgeapi_07_0766.html
indexId: d472db69e5310050b1dcc14cdf40ca389528edad35659c52c0b765288efaac0c72
---
# create_input

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |


#### 功能说明

创建图输入。


#### 函数原型

```
create_input(index: int, *, name: Optional[str] = None, type_str: Optional[InputType] = InputType.DATA, data_type: Optional[DataType] = DataType.DT_FLOAT, format: Optional[Format] = Format.FORMAT_ND, shape: Optional[List[int]] = None) -> TensorHolder
```


#### 参数说明

| 参数名 | 输入/输出 | 描述 |
| --- | --- | --- |
| index | 输入 | 输入索引。 |
| name | 输入 | 可选输入，输入名称，默认为"input\_{index}"。 |
| type\_str | 输入 | 可选输入，输入类型，默认为DATA。详见InputType。 |
| data\_type | 输入 | 可选输入，数据类型，默认为DT\_FLOAT。详见DataType。 |
| format | 输入 | 可选输入，数据格式，默认为FORMAT\_ND。详见Format。 |
| shape | 输入 | 可选输入，形状维度列表，None表示标量。 |


#### 返回值说明

(TensorHolder) 表示输入的张量持有者。


#### 约束说明

- 如果参数类型不正确，抛出TypeError。
- 如果输入创建失败，抛出RuntimeError。