POST
/
api
/
open
/
v2
/
instance
/
create_by_pod
通过Pod创建实例
curl --request POST \
  --url https://www.chenyu.cn/api/open/v2/instance/create_by_pod \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "pod_uuid": "<string>",
  "pod_tag": "<string>",
  "gpu_uuid": "<string>",
  "gpu_nums": 123
}'
{
  "code": 123,
  "msg": "<string>",
  "data": {
    "instance_uuid": "<string>",
    "status": 123,
    "title": "<string>",
    "create_time": 123,
    "start_time": 123,
    "server_url": [
      {}
    ],
    "save_image_status": 123,
    "charging_type": 123,
    "shutdown_regular": {
      "shutdown_time": 123,
      "enable": true
    },
    "image_uuid": "<string>",
    "image_name": "<string>",
    "image_tag": "<string>",
    "gpu_uuid": "<string>",
    "gpu_name": "<string>",
    "gpu_nums": 123
  }
}

​
通过Pod创建实例

使用应用市场中的Pod创建一个新的GPU实例。

​
请求参数

​
pod_uuid
string
required
Pod uuid，可通过查询应用市场Pod接口获取
​
pod_tag
string
Pod版本标签，默认使用最新版本
​
gpu_uuid
string
required
GPU型号uuid
​
gpu_nums
integer
required
使用GPU数量，可选值：1/2/4/8

​
响应参数

​
code
integer
响应码
​
msg
string
响应信息
​
data
object
返回的实例数据

​
代码示例

import requests
from datetime import datetime

url = "https://www.chenyu.cn/api/open/v2/instance/create_by_pod"
headers = {
    "Authorization": "Bearer your_api_key",
    "Content-Type": "application/json"
}

data = {
    "pod_uuid": "pod_12345678-1234-1234-1234-123456789012",
    "pod_tag": "v2.0",
    "gpu_uuid": "gpu_87654321-4321-4321-4321-210987654321",
    "gpu_nums": 1
}

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"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']}")

​
响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "instance_uuid": "inst_12345678-1234-1234-1234-123456789012",
    "status": 1,
    "title": "PyTorch深度学习实例",
    "create_time": 1703145600,
    "start_time": 1703145660,
    "server_url": [
      "https://jupyter-inst123.chenyu.cn",
      "https://ssh-inst123.chenyu.cn"
    ],
    "save_image_status": 2,
    "charging_type": 1,
    "shutdown_regular": {
      "shutdown_time": 1703232000,
      "enable": true
    },
    "image_uuid": "img_87654321-4321-4321-4321-210987654321",
    "image_name": "PyTorch 2.0 环境",
    "image_tag": "v2.0",
    "gpu_uuid": "gpu_87654321-4321-4321-4321-210987654321",
    "gpu_name": "NVIDIA RTX 4090",
    "gpu_nums": 1
  }
}