快速开始

三分钟接入星河API

01 注册账号

发送 POST 请求注册，或在网页端注册。注册成功后会返回你的 API Key。

POST /api/v1/auth/register
Content-Type: application/json

{ "username": "your_name", "password": "your_password" }

→ { "apiKey": "sk_live_xxxx..." }

02 开通接口

登录后在 API 市场选择接口并开通。

POST /api/v1/apis/subscribe/1
Authorization: Bearer your_token

03 调用接口

通过网关调用，Header 中传入 API Key。

GET /gateway/hitokoto
X-API-Key: sk_live_xxxx

→ { "hitokoto": "人生如逆旅，我亦是行人。" }

认证方式

Header（推荐）

X-API-Key: sk_live_xxxx

Query 参数

?apikey=sk_live_xxxx

错误码

Code说明
200成功
400请求参数错误
401未认证 / API Key 无效
403无权限 / 额度不足
429请求频率超限
500服务器内部错误

API 基础地址

https://starriver-api.2709923043.workers.dev