---
name: umodelverse-key-creator
version: 1.0.0
description: |
  在 UCloud ModelVerse 平台中创建用于 AI 推理的 API Key。当 AI Agent 需要为某个 AI 应用或部署服务开通大模型调用权限时使用此技能。
  适用场景包括：为新 AI 应用分配认证凭据、为推理服务配置访问密ß钥、按项目隔离不同业务的 API 权限。
license: MIT
compatibility:
  runtime: "UCloud ModelVerse API"
  dependencies: []
parameters:
  - name: project_id
    type: string
    required: true
    description: "项目ID。用于标识该 API Key 归属的 UCloud 项目，实现多项目资源隔离。"
  - name: name
    type: string
    required: true
    description: "API Key 的名称。建议使用具有业务含义的命名规范，如 `project-{项目名}-service-{服务名}`。"
  - name: daily_limit_amount
    type: string
    required: false
    description: "日消费限额，单位为美元。用于控制成本，防止单日超额调用。"
  - name: monthly_limit_amount
    type: string
    required: false
    description: "月消费限额，单位为美元。用于控制月度预算。"
  - name: grant_all_models
    type: boolean
    required: false
    default: true
    description: "是否授予该 Key 全部模型访问权限。若设为 false，则需通过 granted_models 参数限制可访问的模型列表。"
  - name: granted_models
    type: string[]
    required: false
    description: "授权的模型列表，格式为数组。仅当 grant_all_models 为 false 时生效。示例：[\"deepseek-ai/DeepSeek-V3.2-Think\"]"
  - name: ip_whitelist
    type: string
    required: false
    description: "IP 白名单，支持 IPv4 地址和网段（CIDR 格式），换行分割。最多支持 100 个。用于限制 API Key 的可调用来源 IP。"
output:
  type: object
  properties:
    key_id: "API Key 的资源 ID"
    key_value: "API Key 的实际密钥值，使用时需严格保密"
    name: "API Key 名称"
    status: "状态码，1 表示正常"
    create_time: "创建时间戳"
---

# UModelVerse API Key 创建器

## 技能概述

本技能为 UCloud ModelVerse 模型服务平台提供 API Key 的自动化创建能力。ModelVerse 平台提供 200+ 精选模型，支持开箱即用的 AI 推理能力[reference:2]。所有 API 请求均需携带有效的 API Key 进行认证，通过本技能创建的 Key 可作为应用接入 ModelVerse 推理服务的唯一凭证[reference:3][reference:4]。

## 适用场景

| 场景 | 说明 |
|------|------|
| 新 AI 应用上线 | 为新建的 AI 应用创建独立的 API Key，实现按应用隔离的权限管理和成本核算 |
| 推理服务部署 | 在 UModelVerse 平台完成模型服务部署后，需创建关联 Key 用于调用[reference:5] |
| 多项目隔离 | 通过 project_id 参数将 API Key 绑定到指定项目，实现资源隔离和分账管理 |
| 权限精细化控制 | 利用 IP 白名单和模型白名单参数，限制 API Key 的使用范围和权限边界 |

## 核心工作流