通过 API 生成 HTTP 和 SOCKS5 代理列表

现有工具或脚本需要可重复的连接列表生成方式时，可以使用代理 API。 先发送一个小型请求并确认输出，再将其集成到更大的工作流程中。

API 与浏览器中的生成操作使用同一账户下的代理服务。 请分别决定流量余额、列表长度、协议和会话行为。

准备账户和请求

在代理控制台创建 API 密钥并妥善保管。 Bearer 密钥用于验证 API 请求；生成的代理凭据则用于验证后续代理连接。

选择 1 至 1,000 的生成数量、协议、会话模式和支持的导出格式。 只有确实需要指定位置时，才添加可选的位置字段。

国家使用两字母代码。指定地区必须同时指定其国家，指定城市必须同时指定其地区。 请使用位置目录中的 ID，不要自行编造地区或城市名称。

粘性会话请求可以包含 1 至 120 分钟的时长。 轮换请求不应包含时长字段。请分别检查会话行为与文本格式。

请求一个小型代理列表

下面的示例使用占位密钥，请求以纯文本返回十条 SOCKS5 配置：

curl https://krantz.run/api/v1/proxies/generate   -H 'Authorization: Bearer YOUR_API_KEY'   -H 'Content-Type: application/json'   -H 'Accept: text/plain'   -d '{"count":10,"protocol":"socks5","session":"rotating","format":"host_port_user_pass"}'

此示例不提供有效密钥或可用代理。仅可使用自己的账户和设置运行。 不要在公开日志或支持消息中包含实际密钥或生成的凭据。

当请求包含完全一致的 Accept: text/plain 请求头时，生成结果每行包含一个代理。 没有该请求头时，响应为 JSON，并包含生成的 proxies 数组。

将响应体交给其他工具之前，先检查 HTTP 状态。 即使脚本把错误响应保存成文本文件，它也不是可以导入的代理列表。

自动化之前先检查输出

将一条生成配置导入目标应用。在增加请求数量之前， 先验证协议、主机、端口和身份验证设置。

返回一个批次，并不承诺其中每条配置都使用不同且永久的出口 IP。 粘性会话的可用性仍然是临时的，位置可用性也可能发生变化。

查看账户流量时，使用余额和用量端点。 再次生成列表并不会购买另一个流量包，也不能说明下一个任务将消耗多少流量。

如果之后需要找到保存的批次，请在自己的操作记录中保留生成 ID。 输出文件包含代理身份验证信息，应妥善保护。

设置文档列出了支持的路由和全部五种导出格式。 协议与费用指南则解释了生成操作本身无法替应用决定的选择。