快速找到所需文档，高效完成接入与排障

接入参数

核心特性

• 协议兼容：支持 OpenAI 兼容格式（chat/completions 与 responses 端点），OpenAI SDK 改一行 base_url 即可切换；千问系托管 Key 另可选 DashScope 原生协议

• 流式 / 非流式：支持 SSE 流式逐字和非流式输出

• 多模态：支持图文混合输入（content 数组形式），能力范围以所托管的上游模型为准

• 纯透传：网关不改写请求体与路径参数，请求原样转发至你登记的上游地址

• 密钥安全：托管 Key 采用加密存储，界面与日志仅展示掩码（如 sk-e4d****5026），明文登记后不可回取；

• 自助管理：支持随时编辑、禁用、删除、轮换托管 Key

如何托管 BYOK Key

1. 登录友盟+官网后台，进入「API Key 管理」页的「BYOK 托管」标签页，点击「+ 登记托管 Key」

   

2. 填写 Key 名称（仅作内部标识）、选择厂商、粘贴你的三方 API Key 明文、填写该厂商的 API 上游地址（各大模型厂商请到官网获取）

3. 保存成功后系统仅回显掩码，并给出你的专属 base_url 指引；每个用户最多托管 10 条 Key，同一 Key 全局唯一（重复登记会自动复用原记录）

4. 调用时将 OpenAI SDK 的 base_url 换为 https://ai.umeng.com/rapi/byok/v1，api_key 原样使用你的三方 Key，model 填上游模型 id 即可

5. 常见各大厂商官方文档对接地址（获取base_url）：

阿里云百炼(推荐)：https://docs.bailian.console.aliyun.com/zh/model-studio/first-api-call-to-qwen

DeepSeek：https://api-docs.deepseek.com/zh-cn/

Kimi：https://platform.kimi.com/docs/get-api-key

MiniMax：https://platform.minimax.cn/docs/api-reference/api-overview

调用示例（以 DeepSeek 为例）

cURL

curl -X POST https://ai.umeng.com/rapi/byok/v1/chat/completions \
  -H "Authorization: Bearer deepseek的API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash",
    "messages": [
        {
            "role": "user",
            "content": "你是谁"
        }
    ],
    "stream": false
  }'

示例返回：

{
    "id": "cb029997-8b1c-474e-80e4-416142c7725d",
    "object": "chat.completion",
    "created": 1792397339,
    "model": "deepseek-flash",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "我是 AI 助手，可以帮你回答问题、处理信息、写作、翻译、代码等。你可以把我当作一个随时在线的智能助手来使用。",
                "reasoning_content": "我们需要回答用户中文“你是谁”。需要介绍自己。简洁。可说明我是AI助手，模型名称等。根据系统：我是通过API提供的AI助手，由深度求索？实际上需要准确：我是DeepSeek最新版模型？系统没明确模型名称。通常回答“我是DeepSeek，由深度求索公司创造的AI助手”。但注意系统提示“你是AI助手，通过API提供”。可以诚实说我是AI助手，可以称呼DeepSeek。需要中文。最终简洁。"
            },
            "logprobs": null,
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 31,
        "completion_tokens": 137,
        "total_tokens": 168,
        "prompt_tokens_details": {
            "cached_tokens": 0
        },
        "completion_tokens_details": {
            "reasoning_tokens": 105
        },
        "prompt_cache_hit_tokens": 0,
        "prompt_cache_miss_tokens": 31
    },
    "system_fingerprint": "e72d3c7f663d3e1383b00b3884cb4501"
}

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="你的三方API Key",   # 客户原始三方 Key，非友盟 API Key
    base_url="https://ai.umeng.com/rapi/byok/v1",
)

stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "你是谁"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

说明：BYOK 为透传模式，上游的模型别名策略会原样体现在响应中（例如请求 deepseek-chat 时响应 model 字段可能显示为 deepseek 官方当前指向的版本名），属正常现象。各厂商对 responses 端点的支持情况以其实际能力为准。