• 简体中文
  • 接口文档

    Geekit 对客户端暴露的是各家上游原本的接口格式,鉴权统一换成 Geekit 自己签发的 令牌。把 SDK 的 base URL 指向网关、把 key 换成 Geekit 令牌,代码不用改。

    鉴权

    Authorization: Bearer sk-xxxxxxxxxxxxxxxx

    令牌在控制台创建,可以限定分组、可用模型、额度与有效期。

    OpenAPI 规范

    机器可读的规范文件随文档一起发布,可直接导入 Postman、Insomnia 或代码生成器:

    文件内容
    relay.json转发接口:对话、图像、音频、向量、重排序等
    api.json管理接口:用户、令牌、渠道、日志、计费

    支持的请求格式

    格式路径前缀说明
    OpenAI Compatible/v1/chat/completions覆盖面最广,默认选它
    OpenAI Responses/v1/responsesResponses 格式
    OpenAI Realtime/v1/realtime含 Azure
    Claude Messages/v1/messagesAnthropic 原生格式
    Google Gemini/v1beta/models/...Gemini 原生格式
    Rerank/v1/rerankCohere、Jina
    Midjourney Proxy/mj图像任务
    Suno/suno音乐任务

    格式转换

    网关可以在格式之间互转,客户端用一种格式就能调到另一种格式的上游:

    • OpenAI Compatible ⇄ Claude Messages
    • OpenAI Compatible → Google Gemini
    • Google Gemini → OpenAI Compatible(仅文本,暂不支持函数调用)
    • 思考内容转普通内容

    示例

    curl https://<你的网关域>/v1/chat/completions \
      -H "Authorization: Bearer $GEEKIT_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gpt-5",
        "messages": [{"role": "user", "content": "你好"}],
        "stream": true
      }'

    计费

    按上游返回的用量计费,区分输入、输出、缓存命中和推理 token,并按渠道倍率换算成 额度。每次请求的计费明细写进日志,可以在控制台按令牌、模型、渠道核对。