快速开始

PerceptLeap 提供 OpenAI 兼容接口。已有 OpenAI SDK 项目通常只需替换 API Key 和 Base URL。

1. 获取账号与 API 令牌

   当前采用邀请制。获得账号后登录 PerceptLeap 控制台，进入“令牌”页面创建专用 API 令牌。

   API 令牌只会完整显示一次。请存入密码管理器或服务端环境变量，不要提交到 Git 仓库或前端代码。

2. 选择令牌分组

   分组	适用模型	当前路由
   deepseek	deepseek-v4-flash、deepseek-v4-pro	DeepSeek 官方 API
   chatgpt-pro	GPT、Codex 与图片模型	CLIProxyAPI
   codex	GPT、Codex 与图片模型	CLIProxyAPI
   default	全部已发布模型	兼容现有令牌

   创建令牌时选择分组。已有 default 令牌无需迁移；应用仍应通过带令牌的 /v1/models 获取实际可用模型。

3. 设置环境变量

   export PERCEPTLEAP_API_KEY="<YOUR_API_KEY>"

4. 发送第一次请求

   cURL

   curl https://newapi.perceptleap.com/v1/responses \
     -H "Authorization: Bearer $PERCEPTLEAP_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "gpt-5.6-sol",
       "input": "用一句话解释什么是 API 网关。"
     }'

   Python

   import os
   from openai import OpenAI
   
   client = OpenAI(
       api_key=os.environ["PERCEPTLEAP_API_KEY"],
       base_url="https://newapi.perceptleap.com/v1",
   )
   
   response = client.responses.create(
       model="gpt-5.6-sol",
       input="用一句话解释什么是 API 网关。",
   )
   
   print(response.output_text)

   Node.js

   import OpenAI from "openai";
   
   const client = new OpenAI({
     apiKey: process.env.PERCEPTLEAP_API_KEY,
     baseURL: "https://newapi.perceptleap.com/v1",
   });
   
   const response = await client.responses.create({
     model: "gpt-5.6-sol",
     input: "用一句话解释什么是 API 网关。",
   });
   
   console.log(response.output_text);

成功响应会包含响应 ID、状态、输出内容和用量信息。完整结构见 Responses API。

下一步

• 通过 GET /v1/models 获取当前可用模型，不要长期依赖硬编码列表。
• DeepSeek Flash 可使用 Responses API；DeepSeek Pro 当前使用 Chat Completions。
• 需要逐字输出时启用流式响应。
• 上线前阅读错误处理和隐私与数据处理。