365 API 开发者中心
客户请求只使用模型目录公布的模型 ID。请在客户控制台创建独立 API Key，并按最小权限选择接口和模型。
基础地址：
https://www.hby365.studio。完整密钥只在创建时显示一次。curl https://www.hby365.studio/v1/chat/completions \
-H "Authorization: Bearer $HBY365_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-001" \
-d '{"model":"MODEL_ID","messages":[{"role":"user","content":"你好"}]}'OpenAI 兼容接口
公开目录只包含国内厂商官方文本模型。接口层已实现；每个模型须通过官方目录校验和最小真实调用后才会变为可调用。
| 方法 | 路径 | 当前状态 |
|---|---|---|
| GET | /v1/models | 可用 |
| POST | /v1/chat/completions | 待官方通道联调 |
| POST | /v1/responses | 待官方通道联调 |
Anthropic 兼容接口
POST /v1/messages 已实现流式与非流式协议转换；工具调用和提示缓存尚未声明兼容。
流式与非流式
国内官方文本路由的 Chat Completions、Responses 与 Anthropic Messages 均支持实时 SSE。客户端断开会取消上游请求并释放预留额度。
图片与视频接口
当前没有发布官方图片或视频模型，这些接口不属于正式生产能力。
/generated/ 产物为客户私有资源。程序下载时必须携带所属客户的 Authorization: Bearer $HBY365_API_KEY；未认证、非所属客户或文件不可用时统一返回 404。
语音接口
当前没有发布官方语音模型，这些接口不属于正式生产能力。
Webhook 签名
投递包含事件 ID、时间戳和 HMAC-SHA256 签名。失败投递按退避策略重试，并可在控制台查看和重投。
SDK 与代码示例
JavaScript 与 Python 客户端覆盖当前发布的文本模型、鉴权、用量、幂等键和结构化错误。
错误码、限流与请求 ID
每个响应包含 X-Request-ID。401 表示密钥无效，403 表示权限不足，429 表示限流，502/503 表示模型通道暂不可用。
幂等规则
写请求可传 Idempotency-Key。同一请求重复提交不会重复预留或扣费；同一键对应不同请求体时返回 409。