跳转到内容

使用您的 API 密钥

您的租用附带一个以 gfk_ 开头的 API 密钥。它的用法和 OpenAI API 密钥完全一样,只是请求会发到您租用的 GPU 上。任何能调用 OpenAI API 的东西都能使用它:官方 OpenAI 库、LangChain、大多数聊天应用,或者一条简单的 curl 命令。

您需要三样东西,都可以在 仪表板 → 当前租用 中找到。

项目值
Base URL(也叫 endpoint、接口地址或 API base)https://gpuflow.app/v1
API 密钥您的密钥,以 gfk_ 开头
模型这块 GPU 上的 AI 模型,例如 qwen2.5:7b(第 1 步说明如何查找)

在下面的示例中,请把 gfk_your_key 换成您自己的密钥。

1. 检查密钥并查找模型名称

标题:1. 检查密钥并查找模型名称

把下面的命令粘贴到终端中:

Terminal window
curl https://gpuflow.app/v1/models \
-H "Authorization: Bearer gfk_your_key"

您会得到类似这样的回复:

{
"object": "list",
"data": [{ "id": "qwen2.5:7b", "object": "model", "owned_by": "gpuflow" }]
}

id(这里是 qwen2.5:7b)就是要使用的模型名称。如果提供者的描述中列出了更多模型,您也可以使用那些名称。

2. 发送第一条消息

标题:2. 发送第一条消息
Terminal window
curl https://gpuflow.app/v1/chat/completions \
-H "Authorization: Bearer gfk_your_key" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen2.5:7b",
"messages": [
{"role": "system", "content": "You are a helpful assistant. Answer briefly."},
{"role": "user", "content": "Write a two-line product description for a steel water bottle."}
]
}'

3. 逐字获取回答(流式输出)

标题:3. 逐字获取回答(流式输出)

加上 "stream": true,回答会边生成边显示,就像在聊天应用里一样。

Terminal window
curl https://gpuflow.app/v1/chat/completions \
-H "Authorization: Bearer gfk_your_key" \
-H "Content-Type: application/json" \
-d '{"model": "qwen2.5:7b", "stream": true,
"messages": [{"role": "user", "content": "Explain what a GPU is in three sentences."}]}'

在应用中使用

标题:在应用中使用

很多应用都有名为“OpenAI-compatible”“Custom OpenAI”或“OpenAI API base”的设置。按下面这样填写:

  1. Base URL / API base / endpoint:https://gpuflow.app/v1
  2. API 密钥:您的 gfk_… 密钥
  3. 模型:第 1 步中查到的名称,例如 qwen2.5:7b

如果应用要求选择“provider”(服务商),请选“OpenAI”或“OpenAI-compatible”。

密钥能做什么,不能做什么

标题:密钥能做什么,不能做什么
  • 它可用于聊天:/v1/models 和 /v1/chat/completions。
  • 在租用结束前一直有效。租用结束后,它会返回 invalid_api_key。
  • 它只属于您。任何拿到它的人都能使用您的租用,所以不要把它粘贴到公开的代码或聊天中。如果泄露了,请在 当前租用 中点击 新密钥。旧密钥会立即失效。

遇到问题?请参阅解决问题。