认证鉴权

简介

ModelVerse API 采用 API Key 进行认证，所有 API 请求均需在 HTTP 请求头中包含有效的 API Key，否则将无法正常调用接口。

获取API Key

请访问 ModelVerse 控制台，在控制台中创建并管理您的 API Key。

注意：请妥善保管您的 API Key，切勿泄露给无关人员，避免出现安全风险。

API Key 管理页面可在 ModelVerse 控制台对应模块中找到，用于查看、创建、删除及重置 API Key。

调用地址

ModelVerse API 提供两种调用地址，两个地址的调用内容、功能完全一致，可根据使用场景选择。

调用地址1（国内主流使用）

GET https://api.modelverse.cn/v1/models

调用地址2（海外场景专用）

主要用于海外无法使用 .cn 域名的场景，调用功能与地址1一致。

GET https://api.umodelverse.ai/v1/models

最简调用

请将下方示例中的 \{api\_key\} 替换为您在控制台获取的有效 API Key，即可完成最简API调用。

curl --location 'https://api.modelverse.cn/v1/chat/completions' \
--header "Authorization: Bearer {api_key}" \
--header 'Content-Type: application/json' \
--data '{
    "model": "deepseek-ai/DeepSeek-R1",
    "messages": [
        {
            "role": "user",
            "content": "一句话描述时代互联这家公司。"
        }
    ]
}' | jq .

预期返回结果

{
  "id": "0a7919c4-981e-438b-ad30-e943b96882b6",
  "object": "chat.completion",
  "created": 1763015400,
  "model": "deepseek-r1-250528",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "域名注册使用时代互联。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 348,
    "total_tokens": 358,
    "prompt_tokens_details": null,
    "completion_tokens_details": {
      "audio_tokens": 0,
      "reasoning_tokens": 185,
      "accepted_prediction_tokens": 0,
      "rejected_prediction_tokens": 0
    }
  },
  "system_fingerprint": "",
  "search_result": null
}

错误码说明

当API请求出现错误时，服务器返回的JSON文本将包含错误相关参数，以下为详细的错误码说明，方便您快速定位问题并解决。

HTTP 状态码	类型	错误码	错误信息	描述
400	invalid_request_error	param_error	Invalid param	参数不合法，调用未支持的接口时会触发此错误
400	invalid_request_error	invalid_messages	Sensitive chat messages	对话内容触发敏感词/合规校验，需调整对话内容后重试
400	invalid_request_error	sensitive_check_error	Sensitive check error	合规/敏感内容检测失败，需检查请求内容合规性
400	invalid_request_error	websearch_error	Web search error	联网搜索失败或不可用，可稍后重试或检查网络环境
400	invalid_request_error	model_error	No permission to use the model	没有该模型的使用权限，需确认模型权限或切换可用模型
400	invalid_request_error	tokens_too_long	Prompt tokens too long	提示词长度超出限制，需精简提示词内容
401	invalid_request_error	auth_error	Validate Certification failed	token无效，需参考鉴权说明获取最新API Key
408	timeout	timeout	Request timeout, please try again later	请求超时，请稍后重试
429	rate_limit_error	rate_limit	Rate limit exceeded, please try again later	触发接口限流，需稍后重试，或检查调用频率
500	internal_error	internal_error	Internal Server Error	服务器内部错误，需联系技术支持排查
500	internal_error	model_server_error	Request llm server Error	LLM服务异常，需稍后重试或联系技术支持
504	timeout	gateway_timeout_error	Gateway timeout, please try again later or use stream api	网关超时，请稍后重试或切换为流式接口调用

（注：文档部分内容可能由 AI 生成）

认证鉴权与错误码说明