模型API服务
使用指南

模型API服务使用指南

为了帮助您更方便地将大模型能力集成到自己的应用中,优云智算平台提供了模型 API 接口,通过调用接口,您可以实现自动问答、文本生成等功能。

我们支持标准的 API Key 鉴权机制,您只需准备三个关键信息,即可免部署快速调用模型服务:

  • 接口地址(URL):模型服务的访问入口
  • API Key:您在平台申请的访问凭证,用于身份验证
  • 模型ID:用来指定调用哪一个大模型(如 DeepSeek、Qwen 等)

通过这三项配置,您可以在客户端或自己的应用中快速接入大模型能力,或在自己的环境中发送请求。目前,我们开放了Chat API 能力,支持对话式交互场景。

一、参数说明

参数名称说明示例值
URLAPI的请求地址,用于指定调用的接口。https://api.modelverse.cn/v1/chat/completions https://api.modelverse.cn/v1
模型ID指定调用的模型名称,用于确定API调用的具体功能。deepseek-ai/DeepSeek-R1 deepseek-ai/DeepSeek-V3-0324 deepseek-ai/DeepSeek-Prover-V2-671B Qwen/QwQ-32B Qwen/Qwen3-235B-A22B
API Key用于验证用户身份的密钥,确保只有授权用户可以访问API服务。点此链接获取Key (opens in a new tab)

二、域名链接说明

  • 请注意:不同客户端可能根据其功能需求选择不同的URL链接,请严格按照客户端的说明填写信息。
客户端类型URL链接说明
通用API调用https://deepseek.modelverse.cn/v1基础API接口,适用于通用功能调用,可能需要根据具体功能指定更多参数。
聊天功能调用https://deepseek.modelverse.cn/v1/chat/completions专门用于聊天功能的API接口,针对对话生成等任务优化,参数和返回结果更聚焦于聊天场景。

三、请求示例

curl --location 'https://deepseek.modelverse.cn/v1/chat/completions' \
--header 'Authorization: Bearer <你的API Key>' \
--header 'Content-Type: application/json' \
--data '{
    "stream": true,
    "model": "deepseek-ai/DeepSeek-R1",
    "messages": [
        {
            "role": "user",
            "content": "say hello to ucloud"
        }
    ]
}'

四、错误码

如果请求错误,服务器返回的JSON文本包含以下参数。

HTTP 状态码类型错误码错误信息描述
400invalid_request_errorinvalid_paramInvalid param参数不合法
400invalid_request_errorinvalid_messagesSensitive chat messages对话内容触发敏感词合规校验
400invalid_request_errorinvalid_modelNo permission to use the model没有模型权限
401invalid_request_errorinvalid_tokenValidate Certification failedtoken 无效,用户可以参考【鉴权说明】获取最新密钥
500internal_errorinternal_errorInternal Server Error
500llm_server_errorllm_server_errorRequest llm server Error
Copyright © 2025 沪ICP备12020087号-61