指南OpId: guide-start

快速开始 — Spider OpenAPI

最近更新: 2026-05-22打开独立文档页

1. 基础信息

Base URL:

https://api.spiderhubs.com

Auth:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Content-Type:

application/json

所有 OpenAPI 端点都挂在 /openapi/v1/ 路径下，使用 Bearer 鉴权。
API Key 在【账户中心】点击「生成」即可获取，仅在生成时展示一次，请妥善保存。
同一账户只持有一把 Key，重新生成会立即让旧 Key 失效。

· 每个端点定价不同（详见各端点页 — 1 / 1.5 / 2 积分）。
· 仅在上游返回 2xx 时扣费；4xx 客户端错误、5xx 上游错误、429 限流、402 余额不足均不扣费。
· 默认每端点 20-300 次/分钟限流，超限返回 429。

HTTP	含义	处置建议
401	缺少 / 无效 / 已禁用的 API Key	检查 Authorization header；如已禁用请在账户中心启用
402	余额不足	前往定价页充值积分
429	触发限流	降低并发；或等待 60 秒后重试
502	上游异常	稍后重试；持续异常请联系支持
504	上游任务超时	通常发生在异步图片生成；可重试

错误响应统一使用 { code, msg } 结构；成功响应直接透传上游 body（无包装），方便对接 OpenAI SDK 等。