> ## Documentation Index
> Fetch the complete documentation index at: https://chenyu.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 通过镜像创建实例
> 使用指定的镜像创建GPU实例
# 通过镜像创建实例
使用个人镜像或算力市场镜像创建一个新的GPU实例。
## 请求参数
镜像uuid，可通过查询镜像接口获取
GPU型号uuid
使用GPU数量，可选值：1/2/4/8
## 响应参数
响应码
响应信息
返回的实例数据
实例uuid
实例状态
实例名称
实例创建时间，秒级时间戳
实例启动时间，秒级时间戳
实例镜像保存状态
* `1`: 上传中
* `2`: 上传成功
* `3`: 上传失败
计费类型
定时关机设置
关机时间，秒级时间戳
是否启用定时关机
实例使用的镜像uuid
实例使用的镜像名称
实例使用的镜像tag
实例使用的gpu uuid
实例使用的gpu名称
实例使用的gpu数量
## 代码示例
```python Python theme={null}
import requests
from datetime import datetime
url = "https://www.chenyu.cn/api/open/v2/instance/create_by_image"
headers = {
"Authorization": "Bearer your_api_key",
"Content-Type": "application/json"
}
data = {
"image_uuid": "img_12345678-1234-1234-1234-123456789012",
"gpu_uuid": "gpu_87654321-4321-4321-4321-210987654321",
"gpu_nums": 2
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
if result['code'] == 0:
instance = result['data']
create_time = datetime.fromtimestamp(instance['create_time'])
print(f"实例创建成功!")
print(f"实例UUID: {instance['instance_uuid']}")
print(f"实例名称: {instance['title']}")
print(f"镜像名称: {instance['image_name']}")
print(f"GPU名称: {instance['gpu_name']}")
print(f"GPU数量: {instance['gpu_nums']}")
print(f"创建时间: {create_time.strftime('%Y-%m-%d %H:%M:%S')}")
if instance['server_url']:
print("服务访问地址:")
for url in instance['server_url']:
print(f" - {url}")
else:
print(f"创建失败: {result['msg']}")
```
```javascript JavaScript theme={null}
const axios = require('axios');
const url = 'https://www.chenyu.cn/api/open/v2/instance/create_by_image';
const headers = {
'Authorization': 'Bearer your_api_key',
'Content-Type': 'application/json'
};
const data = {
image_uuid: 'img_12345678-1234-1234-1234-123456789012',
gpu_uuid: 'gpu_87654321-4321-4321-4321-210987654321',
gpu_nums: 2
};
axios.post(url, data, { headers })
.then(response => {
const result = response.data;
if (result.code === 0) {
const instance = result.data;
const createTime = new Date(instance.create_time * 1000);
console.log('实例创建成功!');
console.log(`实例UUID: ${instance.instance_uuid}`);
console.log(`实例名称: ${instance.title}`);
console.log(`镜像名称: ${instance.image_name}`);
console.log(`GPU名称: ${instance.gpu_name}`);
console.log(`GPU数量: ${instance.gpu_nums}`);
console.log(`创建时间: ${createTime.toLocaleString()}`);
if (instance.server_url.length > 0) {
console.log('服务访问地址:');
instance.server_url.forEach(url => {
console.log(` - ${url}`);
});
}
} else {
console.log(`创建失败: ${result.msg}`);
}
})
.catch(error => {
console.error('Error:', error.response.data);
});
```
```curl cURL theme={null}
curl -X POST "https://www.chenyu.cn/api/open/v2/instance/create_by_image" \
-H "Authorization: Bearer your_api_key" \
-H "Content-Type: application/json" \
-d '{
"image_uuid": "img_12345678-1234-1234-1234-123456789012",
"gpu_uuid": "gpu_87654321-4321-4321-4321-210987654321",
"gpu_nums": 2
}'
```
## 响应示例
```json theme={null}
{
"code": 0,
"msg": "success",
"data": {
"instance_uuid": "inst_87654321-4321-4321-4321-210987654321",
"status": 1,
"title": "自定义镜像实例",
"create_time": 1703145600,
"start_time": 1703145660,
"save_image_status": 2,
"charging_type": 1,
"shutdown_regular": {
"shutdown_time": 0,
"enable": false
},
"image_uuid": "image-uuid-123",
"image_name": "pytorch",
"image_tag": "2.0",
"gpu_uuid": "gpu-uuid-123",
"gpu_name": "RTX 4080",
"gpu_nums": 1
}
}
```