全部文档
当前文档

暂无内容

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

文档中心

模型API服务快速入门

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

本文主要向您介绍如何在本地或者其他第三方平台上调用星流平台的模型API。

前提条件

  • 已开通模型API服务。

  • 已获取星流平台操作权限。

创建API Key

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

  2. 在API Key 管理页面,点击+新建

  3. 在弹出提示框中,根据以下要求配置各县参数,点击确定即可。

    • API Key 名称:用户自定义,根据实际情况进行填写即可。

    • 权限:此处建议选择全选,方便访问全部模型资源。

    • 其他参数:根据实际情况填写或保持默认即可。

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

开通模型

  1. 在左侧导航栏,选择额度及开通管理。

  2. 在额度及开通管理页面,点击批量开通。

  3. 在弹出提示窗口中,勾选待使用的模型名称和已阅读并同意相关协议,点击确定开通。

调用模型API

直接调用

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

  2. 选择待调用的模型,点击API调用,进入模型详情页面,可查看模型调用示例和可用的API Key。

  3. 平台已提供 Rest API调用和OpenAI SDK调用示例,您可直接复制示例并修改相应的 KSC_API_KEY 进行调用。

    KSC_API_KEY:为前文创建的API Key,您可直接在API调用页面,直接复制即可。

  • Rest API调用请求示例

    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": "写一首关于春天的五言绝句"}
        ]
    }'
  • Rest API调用返回示例

    {
        "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
        }
    }
  • OpenAI Python SDK调用示例

     # !pip install --upgrade "openai>=1.0"
    import os
    from openai import OpenAI
    
    API_KEY = "b57c3bf5-xxxx-xxxx-xxxx-18bfbd4d9e62"
    MODEL = "deepseek-r1-0528"
    
    client = OpenAI(
        api_key="b57c3bf5-xxxx-xxxx-xxxx-18bfbd4d9e62",
        base_url="https://kspmas.ksyun.com/v1/",
    )
    
    # Non-streaming:
    print("----- standard request -----")
    completion = client.chat.completions.create(
        model="deepseek-r1-0528",  # your model endpoint ID
        messages=[
            {"role": "system", "content": "你是人工智能助手"},
            {"role": "user", "content": "常见的十字花科植物有哪些?"},
        ],
    )
    print(completion.choices[0].message.content)
  • OpenAI Python SDK调用结果

第三方应用调用

以下内容以 Chatbox 为例,向您介绍如何在第三方应用中,调用平台的模型 API。

  1. 进入Chatbox的设置页面。

  2. 在左侧导航栏,选择模型提供方 > +添加。

  3. 在弹出的提示窗口中,按照如下要求配置参数,点击添加

    • 名称:用户自定义,此处示例为“KC星流”

    • API模式:选择OpenAI API兼容。

  4. 按照如下要求配置模型提供方的详细信息。

    • API密钥:前文创建API Key操作中已提前创建,直接复制获取即可。

    • API主机:直接填写 https://kspmas.ksyun.com/v1

    • 其他参数保持默认即可。

  5. 点击获取,在弹出的模型列表中,选择并待使用的模型即可。

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

纯净模式

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