runbase 是什么？AI API、森林跑站与 adidas Runbase 分流，附 403 排查
简答：runbase.net 是 AI 图像与视频生成 API 聚合平台；runbase.com.tw 是台北森林跑站；Adidas Runbase 指向 adidas 相关跑步空间或活动。runba.lol 是本站的第三方网络指南站。
定义：runbase 是一个多义搜索词，至少要区分 runbase.net AI 模型 API 平台、runbase.com.tw 台北森林跑站、Adidas Runbase 跑步空间，以及本站 runba.lol。
先看分流表：你要找的是哪一个 runbase？
搜索 runbase 时，先看完整域名，再决定是否登录或提交 API 密钥。你可能想找的是在线 AI 接口，也可能是在找线下跑步空间；本站 runba.lol 是第三方网络与客户端使用指南站，与这些名称相近的站点没有官方关系，不提供 Runbase 账号或 API 服务。
| 搜索目的 | 优先核对的对象 | 可以确认的内容 | 下一步 |
|---|---|---|---|
| 调用图像或视频生成 API | runbase.net | 官方文档将 Runbase 定义为统一调用多种 AI 图像与视频模型的 REST API，并提供模型、认证、计费和错误码文档。 | 从官方文档进入模型页，确认模型 ID、请求路径和认证方式。 |
| 查找台北跑者空间 | runbase.com.tw | 森林跑站官方页面介绍大安森林公园附近的跑者空间、寄物柜、淋浴间、课程和咖啡等服务。 | 营业时间、店休和现场服务以官方页面或公告为准。 |
| 寻找 Adidas Runbase 跑步空间或活动 | adidas 官方渠道 | 这是与 adidas 跑步社群、活动或线下空间相关的搜索方向，具体门店、活动和服务不要只根据第三方文章判断。 | 通过 adidas 官方网站、应用或当地官方活动页面核对。 |
| 查找本站网络排查文章 | runba.lol | 本站定位是第三方网络、客户端、DNS、延迟和连接问题使用指南，不是上述对象的官方网站。 | 按问题进入站内指南，不要把本站当作 Runbase API 控制台。 |
最快判断法：想调用接口就核对 runbase.net；想找台北跑站就核对 runbase.com.tw；想找 Adidas Runbase，就以 adidas 官方渠道为准；想排查网络问题，再查看本站对应指南。Runbase 官方文档可见Introduction - Runbase Docs，模型列表可见Models - Runbase。
runbase.net 是什么？API 能做什么？
Runbase.net 的官方文档把它定位为一个统一 REST API：开发者可以使用一个 API 密钥，通过统一接口调用多个图像和视频生成模型，不必为每个模型分别安装 SDK。文档还说明，任务采用异步运行方式，通常是先提交任务，再根据运行 ID 查询结果。具体能力和模型 ID 必须以模型页面为准，例如官方模型页列出了 google/nano-banana-2，而不是自行猜测一个相近名称。
适合先确认三件事：第一，模型是否仍在模型列表中；第二，模型 ID 是否与 API 页面完全一致；第三，输入字段是否符合该模型的参数表。官方 Nano Banana 2 API 页面给出了认证方式、异步任务、模型 ID、输入字段和错误码示例。
| 核对项 | 正确做法 | 常见错误 |
|---|---|---|
| 域名与路径 | 从官方文档确认 https://runbase.net/api/v1/runs 和状态查询路径。 | 把搜索结果中的陌生 API 地址直接复制到程序里。 |
| 模型 ID | 从模型 API 页面复制完整 ID，例如 google/nano-banana-2。 | 把展示名称、旧版本号或自行拼出的名称当成 ID。 |
| 认证 | 使用 Authorization: Bearer sk-... 请求头，并把密钥放在环境变量中。 | 把密钥写入公开代码、截图、日志或前端页面。 |
官方认证文档说明 API 密钥以 Bearer 方式放在请求头中，并提供 IP 白名单和消费上限设置；相关说明见Authentication - Runbase Docs。
runbase.net API 调用失败：先用 curl 分清超时、403 与 TLS
先不要同时更换模型、密钥、代理和 DNS。每次只改变一个变量，并保留 HTTP 状态码、错误 JSON、网络类型和测试时间。下面的示例使用官方文档中的 API 路径与模型 ID；如果你使用的是其他模型，应先替换为模型页面明确列出的 ID。
- 先测直连状态和 TLS。macOS、Linux 或 Windows PowerShell 可使用
curl.exe查看详细握手和响应头。PowerShell 中建议明确写curl.exe，避免被 PowerShell 别名替换。
curl.exe -v --connect-timeout 10 --max-time 60 "https://runbase.net/api/v1/runs" -H "Authorization: Bearer $env:RUNBASE_API_KEY" -H "Content-Type: application/json" --data-binary "@body.json"上面的 PowerShell 示例假定当前目录已有 body.json，内容可写成下面这样，避免在 Windows 命令行中处理多层引号：
{
"model":"google/nano-banana-2",
"input":{"prompt":"A ceramic lamp on a wooden table","aspect_ratio":"1:1"}
}- 确认代理是否真正生效。本地代理端口常见为
7897或7890，以客户端设置页为准。先用显式代理参数测试，再用环境变量测试；curl 官方文档说明-x会指定代理，并会覆盖同类环境变量。
curl.exe -v -x "http://127.0.0.1:7897" --connect-timeout 10 --max-time 60 "https://runbase.net/api/v1/runs"$env:HTTPS_PROXY="http://127.0.0.1:7897"
curl.exe -v --connect-timeout 10 --max-time 60 "https://runbase.net/api/v1/runs"如果客户端使用 SOCKS 代理，不能把协议随意写成 HTTP，应按客户端设置改为 socks5:// 或 socks5h://。测试后要查看连接日志是否命中预期策略，也可以对比直连和代理下的出口 IP。出口 IP 查询命令应单独执行，避免与 API 请求拼在同一个代码块：
curl.exe -4 "https://api.ipify.org?format=json"该命令格式可对照ipify API；它只能帮助比较出口地址，不能证明 API 密钥、模型或账户权限正确。
- 记录错误 JSON。官方错误文档明确区分 401、402、403、404、429 和 500。不要把所有失败都归因于网络线路。
| 现象 | 自查方式 | 优先处理 |
|---|---|---|
| 连接超时或 TLS 握手失败 | 用 curl.exe -v 对比直连、代理和手机热点。 | 确认 DNS、代理协议、代理端口和系统时间；一次只改一个变量。 |
| 401 | 检查是否发送 Bearer 请求头、密钥是否完整、密钥是否被禁用或过期。 | 在控制台重新生成或重新启用密钥，不要把密钥发给他人。 |
| 402 | 查看账户余额或任务所需额度。 | 按官方账户页面处理余额问题。 |
| 403 | 读取错误 JSON 中的代码。 | 如果是 ip_not_allowed，检查 API 密钥白名单；如果是 api_key_spend_limit_exceeded，检查消费上限。 |
| 404 | 确认运行 ID、请求路径和使用的密钥。 | 只查询由当前账户和当前密钥创建的运行记录。 |
| 429 | 查看是否短时间内重复提交。 | 降低请求频率，按官方说明采用逐步延长等待时间。 |
上述状态码和错误代码来自Error Codes - Runbase Docs。官方文档明确写出，403 可能对应 IP 不在白名单或密钥消费上限已达到；因此应先读取错误代码，再决定是改网络还是改控制台设置。
如何判断是网络延迟，还是 API 本身处理时间？
API 任务通常是异步的，所以“HTTP 请求很快返回”不等于图像或视频已经生成完成。建议把时间拆成三段：域名解析和 TLS 建连、提交请求的网络耗时、任务从 pending 到 succeeded 的处理耗时。先用 curl -w 记录连接阶段：
curl.exe -o response.json -sS -w "http=%{http_code} dns=%{time_namelookup} connect=%{time_connect} tls=%{time_appconnect} start=%{time_starttransfer} total=%{time_total}\n" "https://runbase.net/api/v1/runs"如果直连和代理的 connect、tls 差异明显，优先排查 DNS、代理协议或网络路径；如果提交阶段相近，但任务完成时间差异大，则应查看任务状态和模型本身的处理情况。不要只用一次请求得出线路排名，也不要把一次超时直接判断为服务长期不可用。
确认域名和客户端问题后，可以继续查看站内的网络与客户端指南；如果需要比较延迟、丢包和线路记录方式，可参考机场推荐与机场测评：不看虚假排名的选择与测速方法。这些页面用于网络排查，不代表任何外部 API 的官方支持入口。
常见问题
下面只保留与 runbase 词义分流和 API 连接排查直接相关的问题，先核对对象，再执行命令。
常见问题
runbase.net 是做什么的？
runbase.net 官方文档将其定义为统一的 AI 图像与视频生成 REST API 平台，支持从模型页面确认模型 ID，通过 API 密钥提交异步任务，再查询运行结果。具体模型和参数以官方文档为准。
runbase.net 返回 403 是网络被封了吗？
不能只凭 403 判断网络问题。官方错误文档列出的原因包括 IP 不在 API 密钥白名单，以及密钥达到消费上限。先读取错误 JSON 中的错误代码，再分别检查出口 IP、白名单和消费上限。
Windows 怎么调用 runbase API，为什么 curl 命令会报 400？
建议在 Windows PowerShell 中使用 curl.exe，并把 JSON 保存为 body.json 后通过 --data-binary "@body.json" 提交，避免 CMD 不展开 PowerShell 环境变量、单引号处理不同以及 JSON 引号被破坏。
runbase.com.tw 和 runbase.net 是同一个网站吗？
不是同一用途。runbase.net 的官方资料围绕 AI 模型 API、认证和任务运行展开；runbase.com.tw 的官方页面介绍台北森林跑站。两者域名和服务类型不同，登录或提交信息前应先核对地址。
Adidas Runbase 应该去哪里确认？
如果你找的是 adidas 相关跑步空间、社群或活动，应通过 adidas 官方网站、应用或当地官方活动页面核对具体地点和安排。第三方文章只能作为线索，不能代替官方公告。
runbase 和 runba.lol 是同一个网站吗？
不是同一个域名。runba.lol 是本站的第三方网络与客户端使用指南站，不提供 Runbase 账号或 API 服务；runbase.net 的 API 账号、密钥和控制台应以其官方域名为准。
相关阅读
参考资料
- Introduction - Runbase Docs（runbase.net）
- Quickstart - Runbase Docs（runbase.net）
- Authentication - Runbase Docs（runbase.net）
- Error Codes - Runbase Docs（runbase.net）
- Models - Runbase（runbase.net）
- Nano Banana 2 API - Runbase（runbase.net）
- 關於跑站 - 森林跑站 RunBase 官方網站（runbase.com.tw）
- curl - How To Use：--proxy 与环境变量（curl.se）
- ipify API（ipify.org）