快速开始 — Spider OpenAPI
SpiderHubs OpenAPI 文档：快速开始 — Spider OpenAPI，分类 指南。所有 OpenAPI 端点都挂在 /openapi/v1/ 路径下，使用 Bearer 鉴权。 API Key 在【账户中心】点击「生成」即可获取，仅在生成时展示一次，请妥善保存。 同一账户只持有一把 Key，...
OpId:
guide-start · 最近更新: 2026-05-221. 基础信息
- Base URL:
- https://api.spiderhubs.com
- Auth:
- Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx
- Content-Type:
- application/json
所有 OpenAPI 端点都挂在 /openapi/v1/ 路径下，使用 Bearer 鉴权。
API Key 在【账户中心】点击「生成」即可获取，仅在生成时展示一次，请妥善保存。
同一账户只持有一把 Key，重新生成会立即让旧 Key 失效。
API Key 在【账户中心】点击「生成」即可获取，仅在生成时展示一次，请妥善保存。
同一账户只持有一把 Key，重新生成会立即让旧 Key 失效。
2. 计费与限流
· 每个端点定价不同（详见各端点页 — 1 / 1.5 / 2 积分）。
· 仅在上游返回 2xx 时扣费；4xx 客户端错误、5xx 上游错误、429 限流、402 余额不足均不扣费。
· 默认每端点 20-300 次/分钟限流，超限返回 429。
· 仅在上游返回 2xx 时扣费；4xx 客户端错误、5xx 上游错误、429 限流、402 余额不足均不扣费。
· 默认每端点 20-300 次/分钟限流，超限返回 429。
3. 错误码
| HTTP | 含义 | 处置建议 |
|---|---|---|
| 401 | 缺少 / 无效 / 已禁用的 API Key | 检查 Authorization header；如已禁用请在账户中心启用 |
| 402 | 余额不足 | 前往定价页充值积分 |
| 429 | 触发限流 | 降低并发；或等待 60 秒后重试 |
| 502 | 上游异常 | 稍后重试；持续异常请联系支持 |
| 504 | 上游任务超时 | 通常发生在异步图片生成；可重试 |
4. 通用响应包装
错误响应统一使用 { code, msg } 结构；成功响应直接透传上游 body（无包装），方便对接 OpenAI SDK 等。
开始调用 SpiderHubs API
使用账户中心生成的 API Key，通过 Authorization: Bearer sk_live_xxx 调用接口。