接入

终端用户标识请求头

每个请求带上你方终端用户的 id，让处置只落到那个用户，而不是整把 key。

为什么需要它

如果你把 DeRouter 作为后端接入自己的产品，多个终端用户会共享同一把 API key。当其中某个用户触发了风控或限流时，处置默认会落到整把 key 上——影响你的全部用户。

带上终端用户标识后，处置会精确落到触发问题的那个用户，其余用户不受影响。

用法

在请求头里加上终端用户的稳定标识即可。

POST https://api.derouter.network/proxy/v1/messages \
  -H "x-api-key: sk-dr-..." \
  -H "x-derouter-end-user-id: user_8f3a91c2" \
  -H "Content-Type: application/json" \
  -d '{ "model": "claude-sonnet-4-6", "messages": [...] }'

注意事项

标识必须在你的系统内稳定——同一用户每次请求都应使用相同值。

不要使用可反推个人身份的信息（邮箱、手机号）；建议用内部用户 ID 或哈希。

缺省该头时，行为与之前一致：处置落到整把 key。