模型API服务使用指南
为了帮助您更方便地将大模型能力集成到自己的应用中,优云智算平台提供了模型 API 接口,通过调用接口,您可以实现自动问答、文本生成等功能。
我们支持标准的 API Key 鉴权机制,您只需准备三个关键信息,即可免部署快速调用模型服务:
- 接口地址(URL):模型服务的访问入口
- API Key:您在平台申请的访问凭证,用于身份验证
- 模型ID:用来指定调用哪一个大模型(如 DeepSeek、Qwen 等)
通过这三项配置,您可以在客户端或自己的应用中快速接入大模型能力,或在自己的环境中发送请求。目前,我们开放了Chat API 能力,支持对话式交互场景。
一、参数说明
参数名称 | 说明 | 示例值 |
---|---|---|
URL | API的请求地址,用于指定调用的接口。 | 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 状态码 | 类型 | 错误码 | 错误信息 | 描述 |
---|---|---|---|---|
400 | invalid_request_error | invalid_param | Invalid param | 参数不合法 |
400 | invalid_request_error | invalid_messages | Sensitive chat messages | 对话内容触发敏感词合规校验 |
400 | invalid_request_error | invalid_model | No permission to use the model | 没有模型权限 |
401 | invalid_request_error | invalid_token | Validate Certification failed | token 无效,用户可以参考【鉴权说明】获取最新密钥 |
500 | internal_error | internal_error | Internal Server Error | |
500 | llm_server_error | llm_server_error | Request llm server Error |