---
title: "创建工具实例"
method: POST
path: "/admin/toolset/instances"
tags: ["toolset"]
---

# 创建工具实例

`POST /admin/toolset/instances`

根据工具ID和参数创建并运行工具实例

## Request body

- ModelToolCreateInstanceReq
  - `args` object
  - `toolId` string

## Response `200`

OK

- ModelToolInstanceHistoryDTO
  - `endTime` string
  - `err` string
  - `id` string
  - `isRunning` boolean
  - `launchUserName` string
  - `ret` integer
  - `startTime` string
  - `tool` ModelToolDTO
    - `allowedSignals` ModelToolSignalDTO[]
      - `description` string
      - `name` string
      - `value` integer
    - `args` ModelToolArgDTO[]
      - `default` unknown
      - `description` string
      - `name` string — Name is the name of the argument.
      - `type` string
    - `description` string
    - `group` string
    - `id` string — ID is the unique identifier for the toolset.
    - `name` string
  - `toolId` string
  - `toolName` string

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/hust-open-atom-club/apis/untitled-api.md) · [All operations](https://skmtc.net/hust-open-atom-club/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hust-open-atom-club/untitled-api/revisions/34214ad5a103/schema)