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,并预填了端点和你选中的 模型。
-
在 API 上点击 Generate New Key。表格顶部会出现一个带名称输入框的新行; Key 列显示 will be generated。
-
输入一个名字 —— 最长 100 个字符,且在你现有的有效密钥中唯一。按 Enter 提交,按 Esc 取消。
-
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 URL | Notes |
|---|---|---|
| OpenAI (chat completions, embeddings, images, videos, SDKs) | https://llm.grafilab.ai/v1 | Clients append /chat/completions, /models, and so on. |
| Anthropic (Messages API, Claude Code, Anthropic SDK) | https://llm.grafilab.ai | Clients append /v1/messages themselves — do not add /v1. |
curl https://llm.grafilab.ai/v1/models \ -H "Authorization: Bearer $GRAFILAB_API_KEY"import osfrom openai import OpenAI
client = OpenAI( api_key=os.environ["GRAFILAB_API_KEY"], base_url="https://llm.grafilab.ai/v1",)import OpenAI from "openai";
const client = new OpenAI({ apiKey: process.env.GRAFILAB_API_KEY, baseURL: "https://llm.grafilab.ai/v1",});被拒绝的密钥会返回 401,code 为 invalid_api_key。最常见的原因是粘贴时带上了
多余的空格或换行。
轮换或删除密钥
Section titled “轮换或删除密钥”两个操作都在该行的 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.
删除是软删除,不可撤销:密钥立刻不再能鉴权,它过去的用量仍留在你的报表里,而密钥 值无法找回。如果你只是想让泄露的密钥失效,请改用轮换 —— 这样能在同一个名字下保留 历史。
按密钥看用量
Section titled “按密钥看用量”每个请求都归属到为它鉴权的密钥,所以按密钥的统计是精确的,不是估算的。
密钥属于账号,而不是创建它的人:团队成员在你的账号下操作时创建的密钥属于你的账 号,而且在该成员离开后依然存在,除非你在移除他时 勾选 Also revoke the API keys this member created。
点击某个密钥所在行的 View Usage,会打开筛选到它的 Inference API Usage —— 怎么读它见 推理用量。

