全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

API Key管理

最近更新时间:2026-04-01 11:56:52

功能简述

API Key是调用平台模型API的凭证,您可以在API Key管理页面进行创建和管理。

前提条件

开通模型API服务

创建API Key

  1. 登录星流平台,在顶部导航栏,选择 API服务 > API Key管理

  2. 点击 +新建,在弹出的提示窗口中,配置各项参数后,点击确定

    参数

    说明

    API Key名称

    必填项。用户自定义的API Key名称(支持字母、数字、下划线,需要字母开头,长度2 - 32个字符)。

    所属项目

    必选项。选择此API Key所属项目,仅同样属于此项目的子账号拥有API Key的使用权限。

    描述

    非必填项。对当前API Key的注释或描述。

    模型访问权限

    必选项
    全选(可访问项目下全部资源):若选择该权限,此API Key将可获取平台内所有模型的访问权限,包括平台后续新增模型。
    自定义(限制可访问资源范围):若选择该权限,您可自主设置允许使用此API Key调用模型的IP地址,或者使用此API Key允许调用平台上的那些模型。

  3. 创建成功的API Key将显示在列表中,您可直接复制使用。

使用API Key

以Rest API调用为例,具体操作如下。

  1. 在左侧导航栏,选择 模型广场

  2. 选择待调用的模型,点击 API调用,进入模型详情页面,复制待使用的API Key。

  3. 直接复制示例,并修改相应的 KSC_API_KEY 进行调用。

    请求示例

    curl -X POST https://kspmas.ksyun.com/v1/chat/completions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer b57c3bf5-xxxx-xxxx-xxxx-xxxxbd4d9e62" \
    -d '{
        "model": "deepseek-r1-0528",
        "messages": [
            {"role": "system", "content": "您是一位中文诗人,请严格遵循五言绝句格式。"},
            {"role": "user", "content": "写一首关于春天的五言绝句"}
        ]
    }'

    返回示例

    {
        "id": "as-5b3r181ffw",
        "object": "chat.completion",
        "created": 1774494594,
        "model": "deepseek-r1-0528",
        "choices": [
            {
                "index": 0,
                "message": {
                    "role": "assistant",
                    "content": "《春晓》\n风暖雪初消,新芽破冻条。\n东君施妙手,一夜绿千梢。\n\n注:本诗以五绝形式勾勒初春景象。首句“风暖雪消”点明气候转暖,次句“新芽破冻”展现生命张力。后两句化用“东风染绿”之意象,以“东君施妙手”拟人手法,将春回大地的自然进程喻为神工挥洒,末句“一夜绿千梢”以夸张笔法渲染春势迅疾,整体形成动静相宜的意境层次。",
                    "reasoning_content": "嗯,用户要求写一首关于春天的五言绝句。五言绝句需要严格遵循格式,每句五个字,共四句,押平声韵。\n\n想到用传统意象来表现春天。柳树发芽是典型春景,可以放在首句。“碧玉”既形容柳色也暗喻新生。第二句用“垂丝”呼应柳枝形态。\n\n后两句需要转折提升意境。想到春风和桃花的互动,用“匀胭脂”比喻春风染红桃花,带出动态美感。整体押“i”韵比较流畅。\n\n赏析可以点明意象选择和拟人手法的运用,说明如何通过简短四句展现春意。"
                },
                "finish_reason": "stop",
                "flag": 0
            }
        ],
        "usage": {
            "prompt_tokens": 26,
            "completion_tokens": 274,
            "total_tokens": 300,
            "completion_tokens_details": {
                "reasoning_tokens": 142
            },
            "web_search_queries": 0
        }
    }

管理API Key

在API Key管理界面,支持对指定API Key进行禁用、启用、编辑以及删除操作。

禁用API Key


当您需要暂停使用某一API Key时,可在API Key列表中,点击目标Key操作列下的禁用

• 被禁用的API Key,再次使用时,相应的模型调用请求将失败。

• 被禁用的API Key,可重新启用。

编辑API Key

若您需要修改某一API Key的基本信息,可在API Key列表中,点击目标Key操作列下的编辑。在弹出的提示框中,支持修改相应API Key的名称描述信息以及权限

删除API Key

若您需要删除某一API Key,可在API Key列表中,点击目标Key操作列下的删除即可。

被删除的API Key不可恢复,请谨慎操作。

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈