跳转到内容

Models

API 密钥

API 密钥是 Grafilab Inference API 每一次调用和 Playground 每一次运行的凭据。密钥 属于账号,数量没有上限,而且每一个都有自己的用量记录 —— 所以按项目或按环境各建一 个密钥不花钱,还能让花费一目了然。

在控制台打开 API。页面标题是 API Management,你的密钥在 API Secret Keys 下面的表格里,列有 Name、 Key、Created Date 和 Actions。

表格上方的 API Endpoint 一行显示 base URL 和一个复制按钮: https://llm.grafilab.ai/v1。

Key 列里的值只保留最后四位。Show Key 会显示完整值,旁边有复制按钮,所以你 早先创建的密钥仍然能从这张表里读出来。

如果你从没创建过密钥,打开这个页面会自动给你生成一个名为 Default 的密钥。这是 正常的;你可以直接用它,也可以自己建一个再把它删掉。

同一页面再往下,Sample API Implementation 给出了 Python、CURL 和 TypeScript 的现成代码片段,覆盖 Text Generation、Image Generation、 Image Edit、Video Generation 和 Image to Video,并预填了端点和你选中的 模型。

  1. 在 API 上点击 Generate New Key。表格顶部会出现一个带名称输入框的新行; Key 列显示 will be generated。

  2. 输入一个名字 —— 最长 100 个字符,且在你现有的有效密钥中唯一。按 Enter 提交,按 Esc 取消。

  3. API Key Created 对话框显示 Key Name 和完整的 Key。现在就复制它,然 后点击 I’ve saved my key。

新密钥形如 sk-grafilab- 后跟 48 个十六进制字符。在这个格式之前签发的密钥依然有 效、依然能鉴权 —— 轮换一次就能把它换成当前格式。

把密钥作为请求头发送。用哪个头取决于你的客户端说哪种方言:

  • OpenAI 接口 —— Authorization: Bearer <api-key>。
  • Anthropic 接口 —— x-api-key: <api-key>,如果 Authorization: Bearer 更方 便也可以用。哪个头存在就用哪个来校验:格式不对的 x-api-key 会直接在那个值上失 败,不会回退到 Authorization。
Your tool speaks…Base URLNotes
OpenAI (chat completions, embeddings, images, videos, SDKs)https://llm.grafilab.ai/v1Clients append /chat/completions, /models, and so on.
Anthropic (Messages API, Claude Code, Anthropic SDK)https://llm.grafilab.aiClients append /v1/messages themselves — do not add /v1.
终端窗口
curl https://llm.grafilab.ai/v1/models \
-H "Authorization: Bearer $GRAFILAB_API_KEY"

被拒绝的密钥会返回 401,code 为 invalid_api_key。最常见的原因是粘贴时带上了 多余的空格或换行。

两个操作都在该行的 Actions 列里,而且都立即生效。

Rotate Key 打开 Rotate API Key:Are you sure you want to rotate this key? The existing key value will immediately stop working. All in-flight requests using the old value will fail. 确认后,API Key Created 对话框会显示 一次新值。

轮换保留同一条密钥记录 —— 它的 id、名字和全部用量历史都会延续,所以你的用量图表不 会断。变的只有密钥本身。

Delete Key 打开 Delete API Key:Are you sure you want to delete this key? This action will invalidate the key, but historical usage data will be preserved.

删除是软删除,不可撤销:密钥立刻不再能鉴权,它过去的用量仍留在你的报表里,而密钥 值无法找回。如果你只是想让泄露的密钥失效,请改用轮换 —— 这样能在同一个名字下保留 历史。

每个请求都归属到为它鉴权的密钥,所以按密钥的统计是精确的,不是估算的。

密钥属于账号,而不是创建它的人:团队成员在你的账号下操作时创建的密钥属于你的账 号,而且在该成员离开后依然存在,除非你在移除他时 勾选 Also revoke the API keys this member created。

点击某个密钥所在行的 View Usage,会打开筛选到它的 Inference API Usage —— 怎么读它见 推理用量。