🚀 1.1 快速入门指南

欢迎来到 Old Dog AI 开放接口平台！

本平台提供完全兼容 OpenAI 官方标准的 API 服务。这意味着，无论您使用的是基于 OpenAI 生态开发的第三方软件（如 Chatbox、NextChat）、AI 编程 IDE（如 Cursor），还是各种极客终端工具（如 Claude Code），您都无需修改任何底层逻辑。

只需替换下面提到的 [基础接口地址] 和 [API Key]，您就能瞬间拥有全球顶尖 AI 模型的使用权。

🔑 第一步：获取您的核心凭证

在进行任何配置之前，您必须准备好两样东西：

1. 基础接口地址 (Base URL)

这是您连接到我们服务器的“网关地址”。请复制并牢记以下链接：

https://api.olddog.shop/v1

⚠️ 【防坑必看】：在 90% 的软件和代码库中，接口地址必须以 /v1 结尾！如果您在后续配置中遇到 404 Not Found 错误，请优先检查是否漏填了 /v1。部分极少数软件自带了路径补全（例如 Chatbox），此时只需填入 https://api.olddog.shop 即可，具体请参考左侧目录中对应的软件专属教程。

2. 认证密钥 (API Key)

这是您的个人专属“通行证”，用于验证您的身份并进行计费。

注册/登录：前往 Old Dog AI 控制台。为了您的隐私与便捷，我们推荐使用 GitHub 或 Google 账号直接授权登录，全程无门槛。
生成密钥：
- 在控制台左侧菜单，点击 【令牌 (Tokens)】。
- 点击页面上的 【+ 添加新的令牌】。
- 您可以为该令牌命名（例如“给Cursor专用”、“手机端专用”），以方便日后管理。您还可以设置过期时间或最大使用额度（留空即为不限制）。
- 点击提交后，系统会弹出一串以 sk- 开头的长字符（例如 sk-abc123xyz...）。请立即点击复制并妥善保存在您的备忘录中。因为一旦关闭窗口，出于安全隐私考虑，完整密钥将无法再次查看（如果遗失，只能删除重建）。

💻 第二步：快速连通性测试 (对于开发者)

如果您是一名开发者，可以在拿到 Key 后，立即通过以下代码快速验证您的网络和密钥是否畅通。

使用 cURL (在终端/命令行直接运行)：

bash

curl [https://api.olddog.shop/v1/chat/completions](https://api.olddog.shop/v1/chat/completions) \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 您的_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "你好，请用一句话证明你在线。"
      }
    ]
  }'

使用 Python (官方 openai 依赖库)： 请先确保安装了官方库：pip install openai

python

import os
from openai import OpenAI

# 初始化客户端，注意替换为我们的 Base URL 和您的 API Key
client = OpenAI(
    api_key="您的_API_KEY", 
    base_url="[https://api.olddog.shop/v1](https://api.olddog.shop/v1)" 
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "你好，测试一下接口连通性。"}
    ]
)

print(response.choices[0].message.content)

🗺️ 第三步：选择您的专属接入场景 (导航地图)

现在，您已经拥有了 Base URL 和 API Key！请根据您日常使用的工具，在左侧目录中寻找对应的保姆级教程：

📱 我是普通用户：不想写代码，只想找个带界面的聊天软件 👉 请查看 [2. 聊天软件接入]。
💻 我是程序员：想在写代码时用 AI 辅助，或者接入编辑器 👉 请查看 [3. AI 编程编辑器]。
⌨️ 我是极客玩家：想玩转 Claude Code 等命令行终端 AI 👉 请查看 [4. 极客终端 CLI 工具]。
👨‍💻 我要独立开发：想将 API 嵌入我自己的商业项目/网站 👉 请查看 [5. 开发者 API 参考] 获取标准接口文档。

🚀 1.1 快速入门指南 ​

🔑 第一步：获取您的核心凭证 ​

1. 基础接口地址 (Base URL) ​

2. 认证密钥 (API Key) ​