7OnTop AI 使用指南

快速开始

登录 7OnTop AI 平台并进入令牌页面。
创建一个可用的 API Key。
将 Base URL 设置为 https://ai.8online.dpdns.org/v1。
在你常用的 AI 应用中填入 API Key 和模型名称。

如果你的应用支持 OpenAI 兼容 接口，通常都可以直接接入。

获取 API Key

API Key 是你访问服务时使用的密钥。创建后请妥善保管，不要公开发送给他人。

建议为不同设备或不同应用分别创建独立 API Key，便于区分使用记录。
如果怀疑泄露，请立即停用旧 Key 并重新创建。
复制后可以先用下方示例请求测试连通性。

API 调用

通用请求信息如下：

Base URL：https://ai.8online.dpdns.org/v1
鉴权请求头：Authorization: Bearer 你的 API Key
模型列表接口：GET /models
对话接口：POST /chat/completions

curl 示例

curl https://ai.8online.dpdns.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的 API Key" \
  -d '{
    "model": "gpt-5.4-thinking",
    "messages": [
      {"role": "user", "content": "你好，请做一个自我介绍"}
    ]
  }'

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="你的 API Key",
    base_url="https://ai.8online.dpdns.org/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.4-thinking",
    messages=[{"role": "user", "content": "你好"}],
)

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

AI 应用配置

以下内容保留普通用户最常用的接入方式。

Cherry Studio

服务商类型：选择 OpenAI 或 OpenAI Compatible
Base URL：https://ai.8online.dpdns.org/v1
API Key：填写你自己的 API Key
模型：从模型列表中选择你需要的名称，例如 gpt-5.4-thinking、claude-opus-4.6、gemini-3.1-pro

支持 OpenAI 兼容接口的通用应用

只要应用允许自定义 Base URL，通常都可以直接接入。
Base URL 填 https://ai.8online.dpdns.org/v1。
API Key 填你自己的 API Key。
模型名称请使用平台实际展示的名称。

连通性检查

如果应用里拉不到模型，可以先访问 /models 接口确认 API Key 是否可用，再回到应用里刷新模型列表。

模型选择

gpt-5.4-thinking：适合复杂推理、长文本分析和高质量通用对话。
gpt-5.4-mini：速度更快，适合轻量问答与日常使用。
claude-opus-4.6：适合高质量写作、总结与内容整理。
gemini-3.1-pro：适合通用创作、信息整理与多场景问答。

如果你不确定先用哪个模型，可以先从 gpt-5.4-mini 或 gpt-5.4-thinking 开始。

常见问题

401 或 403

通常是 API Key 无效、已停用，或复制时多了空格。请重新复制后再试。

429

表示当前请求过于频繁。请稍后重试，或减少短时间内的连续请求。

模型不存在

请确认你填写的是平台当前展示的模型名称，名称需要完全一致。

应用中显示连接失败

请先检查 Base URL 是否填写为 https://ai.8online.dpdns.org/v1，然后确认 API Key 是否有效。

拉起应用后没有看到模型

先刷新模型列表；如果仍然没有，请用 /models 接口确认账号下可用模型是否正常返回。