FluxToken 文档

连接与超时 ​

ETIMEDOUT、ECONNREFUSED、SSL certificate problem、stream error、 首字很慢 —— 这一页讲网络层的问题。

📌
先看服务状态页

网络类报错里，有相当一部分根本不是你的网络问题，而是上游渠道在波动。

第一件事永远是：https://status.fluxtoken.ai/

整个分组都在波动 → 等一会，或换分组。 只有你一个人不通 → 往下看。

按报错原文查 ​

报错原文一句话原因跳转
ETIMEDOUT连不上端点，或连接建立后很久没响应下节
ECONNREFUSED端点地址写错，或被代理/防火墙拦了下节
SSL certificate problem中间人代理，或系统根证书过旧下节
stream error / 流式中断上游波动或网络抖动下节
首字很慢福利档渠道特性下节
socket hang up连接被中途断开下节
DNS 解析失败域名解析被拦或 DNS 污染见下

ETIMEDOUT（连不上） ​

现象 ​

请求挂着不动，最后报 ETIMEDOUT 或 request timeout。

原因 ​

  1. 网络到端点的路径不通 —— 你用的端点对你的网络位置不合适
  2. 中间有代理，代理没配好
  3. 上游渠道响应慢 —— 长文本、生图、高峰期尤其明显

解决 ​

按顺序试，每步之后重发一次：

  1. 换端点。 这是最有效的一步：

    国内加速https://cn.fluxtoken.ai默认使用。国内网络首选，延迟更低。
    全球站 · 源站直连https://api.fluxtoken.ai港澳台及境外用户请用此地址；国内加速异常时也可回退到这里。

    两个端点功能完全相同，只是入口不同。 港澳台及境外用户应该用 api 那个；国内加速异常时也回退到它。

    两个端点分别测一次
    curl -s -o /dev/null -w "cn   %{http_code}  %{time_total}s\n" \  https://cn.fluxtoken.ai/v1/models -H "Authorization: Bearer sk-你的令牌"curl -s -o /dev/null -w "api  %{http_code}  %{time_total}s\n" \  https://api.fluxtoken.ai/v1/models -H "Authorization: Bearer sk-你的令牌"

    200 且 time_total 小 = 这个端点通。哪个好用哪个。

  2. 看服务状态页 https://status.fluxtoken.ai/ —— 确认不是分组在波动。

  3. 换分组试 —— 福利档（【Codex】反代 · 福利、【Grok】Heavy· 福利 等） 本身就有「不稳定时切换其他分组」「首字较慢」的官方说明。 换到 稳享 / 尊享 档对比一下。

  4. 加大超时并放宽重试 —— 长输出和生图本身耗时很长，客户端默认超时可能不够。

  5. 检查代理配置 —— 见下节。

ECONNREFUSED（连接被拒） ​

现象 ​

立刻失败，不是超时，而是「连接被拒绝」。

原因 ​

  1. 端点地址写错 —— 域名拼错、端口写错、多写了路径
  2. 代理配置冲突 —— 本地代理软件把请求导向了一个不存在的端口
  3. 防火墙拦截

解决 ​

  1. 逐字核对端点地址

    正确常见错误
    https://cn.fluxtoken.aicn.fluxtoken.ai（少了 https://）
    https://cn.fluxtoken.ai/v1https://cn.fluxtoken.ai/v1/（多余斜杠，非致命但注意）
    https://api.fluxtoken.ai混用两个域名的片段

  2. 检查代理环境变量 —— 这几个变量经常是「上次开了代理忘了关」留下的：

    检查代理变量
    echo $HTTP_PROXYecho $HTTPS_PROXYecho $ALL_PROXYecho $NO_PROXY

    有输出但你并不需要代理时，清掉它们：

    清掉代理变量（当前终端）
    unset HTTP_PROXY HTTPS_PROXY ALL_PROXY

  3. 检查本地代理软件 —— 关闭代理软件后重试一次。 如果关了代理就通了，说明是代理软件的分流规则把 API 域名也代理走了。

  4. 确认没有写错端口 —— 端点用的是标准 HTTPS 端口，不需要在地址里写端口号。

SSL certificate problem ​

现象 ​

TLS 握手失败，常见文案：

  • SSL certificate problem: unable to get local issuer certificate
  • certificate verify failed
  • unable to verify the first certificate

原因 ​

  1. 中间人代理 —— 某些代理软件、企业防火墙、杀毒软件会替换 TLS 证书， 客户端校验时不认
  2. 系统根证书库过旧 —— 老版本系统或精简版镜像缺根证书
  3. 真的是网络被劫持（较少见）

解决 ​

  1. 确认不是中间人代理 —— 关掉代理软件/关闭 HTTPS 扫描功能后重试。

  2. 更新根证书

    更新 CA 证书（Debian/Ubuntu）
    sudo apt-get update && sudo apt-get install -y ca-certificates

    macOS 用系统自带的「钥匙串访问」更新；Windows 走系统更新。

  3. Node.js 环境额外注意 —— Node 不一定读系统证书库。 如果你在用 Node 客户端且报证书错误，先试试：

    让 Node 用系统证书
    export NODE_EXTRA_CA_CERTS=/etc/ssl/certs/ca-certificates.crt

不要用关闭证书校验来「解决」

把 NODE_TLS_REJECT_UNAUTHORIZED=0 或客户端的「忽略证书错误」打开， 等于把你的令牌和全部对话内容明文暴露给中间人。 这是把连接问题换成了安全问题，不要这么做。

  1. 如果以上都不行，换端点试（cn ↔ api），两个端点的网络路径不同。

stream error / 流式中断 ​

现象 ​

流式输出到一半断掉，常见文案：

  • stream error
  • socket hang up
  • connection reset by peer
  • 输出到一半卡住不动

原因 ​

  1. 上游渠道波动 —— 最常见的成因
  2. 网络抖动 —— 长连接更容易被中途掐断
  3. 代理/防火墙对长连接有超时限制
  4. 服务端或客户端缓冲区问题

解决 ​

  1. 看服务状态页 https://status.fluxtoken.ai/ —— 是不是该分组在波动。

  2. 换分组试 —— 福利档渠道波动更明显。 官方说明里就写着「不稳定时切换其他分组」。

  3. 换端点试 —— cn ↔ api 的网络路径不同，一条不稳另一条可能稳。

  4. 重试机制（推荐写进代码） —— 流式中断是可恢复的典型场景， 加上重试能显著改善体验：

    • 对 500 / 502 / 504 和连接类错误做重试
    • 用指数退避（1s → 2s → 4s …），别做高频立即重试
    • 给重试设上限（比如 3 次），避免把问题放大成雪崩

  5. 临时改成非流式 —— 如果只是要拿到结果，stream: false 能绕开长连接被掐断的问题。

重试要注意计费

已返回部分结果的请求可能已按实际用量计费。 重试是在重新发一次请求，会重新产生费用。 对长输出做盲重试前，先确认成本可接受。

首字很慢 ​

现象 ​

请求发出后，很长时间没有第一个字，但一旦开始输出就很正常。

原因 ​

这通常是福利档渠道的固有特性，不是故障。

官方说明里对部分分组直接写了「首字较慢」「可用性随渠道波动」。 比如 【Grok】Heavy· 福利 的说明就是「福利渠道，首字较慢，不影响使用」。

便宜的价格对应的是不同的上游线路，不是「同样的东西打折」。参见怎么选分组。

解决 ​

  1. 先确认是渠道特性还是真故障 —— 看服务状态页。

  2. 如果是渠道特性，按需要选一条：

    你在意什么怎么办
    便宜，能等保持福利档
    要响应快换 稳享 / 尊享 档
    要既快又稳换 企业级 / 官Key / 顶享 这类旗舰档

  3. 换端点试一次 —— 有时是网络路径问题，不是渠道问题。

  4. 确认不是客户端在缓冲 —— 有些客户端会等完整响应才显示。 用 curl 直接看首字时间，排除客户端因素：

    测首字时间
    curl -s -N -w "\n首字耗时: %{time_starttransfer}s\n" \  https://cn.fluxtoken.ai/v1/chat/completions \  -H "Authorization: Bearer sk-你的令牌" \  -H "Content-Type: application/json" \  -d "{\"model\":\"gpt-5.5\",\"stream\":true,\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}" | head -20

DNS 解析失败 ​

现象 ​

  • getaddrinfo ENOTFOUND
  • Could not resolve host
  • Name or service not known

原因 ​

域名根本没解析出来。可能是 DNS 服务器不工作，或解析被干扰。

解决 ​

  1. 确认域名拼写正确（fluxtoken.ai，注意不是 fluxtoken.com 之类）。

  2. 换 DNS 服务器试试（改成公共 DNS），或用 IP 直连测试排除 DNS 因素：

    测试域名解析
    nslookup cn.fluxtoken.ainslookup api.fluxtoken.ai

  3. 换端点 —— 两个域名的解析路径不同，一个失败另一个可能正常。

  4. 换网络 —— 切到手机热点试一次，能快速判断是本地网络还是域名的问题。

通用排查顺序 ​

网络类问题，按这个顺序走最省时间：

  1. 看服务状态页 https://status.fluxtoken.ai/
  2. 换端点（cn ↔ api）—— 两个地址功能相同，只是入口不同
  3. 换分组 —— 尤其是从福利档换到稳享/尊享档
  4. 关掉代理软件再试一次，同时清理代理环境变量
  5. 用 curl 直连 —— 排除客户端自身的缓冲、超时、证书问题
  6. 加超时和重试 —— 长输出、生图本身就慢
  7. 换网络（例如切手机热点）判断是本地网络还是上游

还不行怎么办 ​

  1. 服务状态页 https://status.fluxtoken.ai/ —— 可用性一律以它为准，文档不承诺 SLA
  2. 控制台的错误请求记录 —— 看失败原因
  3. 报错原文索引 —— 报错原文索引
  4. 进群 —— QQ 群 1108757955 · Telegram https://t.me/fluxtokengroup

进群请附上：完整报错原文、端点地址、分组名、发生时间、你的网络位置（境内/境外）。

网络问题最需要「对照」

同一个报错，别人通你不通 → 你的本地网络问题； 你通别人不通 → 也是你的本地网络问题； 大家都不通 → 上游波动。进群问之前，先自己测一下两个端点，结论会清晰很多。

相关页面 ​

数据快照：2026-10-08 · 站点版本 0.2.11
来源：模型广场接口 · 价格接口
文档站数据随构建自动更新；实时价格、可用性与限额请以控制台实际展示为准。

本页内容为使用指引；具体服务以《服务条款》与实际账务记录为准。

Copyright © 2026 FluxToken