基础接入与 Agent 替换指南

绿师傅API 兼容 OpenAI API 格式。大多数 Agent、工作流、聊天客户端、代码助手，只要支持填写 OpenAI Base URL 和 API Key，就可以直接接入。

适合开发者 API 调用场景

绿师傅API 提供统一的 API Key、模型、分组与倍率管理。高频任务仍要关注上游渠道、额度和速率限制，但接入层会更集中、更好管理。

1. 准备信息

Base URL https://newapi.666wlx.com/v1

API Key 登录控制台后，在「令牌」里新建并复制。

打开你的 Agent 或 AI 客户端设置。
供应商选择 OpenAI 或 OpenAI Compatible。
API 地址填写 https://newapi.666wlx.com/v1。
API Key 填写你在绿师傅API控制台创建的令牌。
模型名填写模型广场中可用的模型名称，例如 gpt-4o。实际可用模型以控制台和渠道配置为准。

2. Python SDK 集成

如果你的 Agent 使用 OpenAI Python SDK，只需要替换 api_key 和 base_url。

agent_setup.py

from openai import OpenAI

client = OpenAI(
    api_key="你的绿师傅API令牌",
    base_url="https://newapi.666wlx.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "你是一个可靠的Agent助手。"},
        {"role": "user", "content": "帮我规划今天的工作。"},
    ],
)

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

LangChain / browser-use 示例

browser_use_llm.py

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="gpt-4o",
    api_key="你的绿师傅API令牌",
    base_url="https://newapi.666wlx.com/v1",
    max_tokens=4096,
)

# 接下来将 llm 传入你的 Agent 或 browser-use 框架即可

3. Node.js 集成

agent.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LUSHIFU_API_KEY,
  baseURL: "https://newapi.666wlx.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    { role: "system", content: "你是一个可靠的Agent助手。" },
    { role: "user", content: "写一个客户跟进计划。" },
  ],
});

console.log(resp.choices[0].message.content);

4. 环境变量方式

很多 Agent 框架会自动读取下面两个变量：

.env / shell

export OPENAI_API_KEY="你的绿师傅API令牌"
export OPENAI_BASE_URL="https://newapi.666wlx.com/v1"

5. 常见 Agent 配置

Cherry Studio / Chatbox / LobeChat：供应商选 OpenAI Compatible，填 Base URL 和 Key。
Dify / FastGPT / 工作流平台：模型供应商选 OpenAI-API-compatible，Base URL 填到 /v1。
自研 Agent：使用 OpenAI SDK，并把 base_url 指向绿师傅API。
browser-use：使用 LangChain 的 ChatOpenAI 或兼容客户端，把模型对象传入 Agent。

6. 快速测试

curl

curl https://newapi.666wlx.com/v1/chat/completions \
  -H "Authorization: Bearer 你的绿师傅API令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好，测试一下绿师傅API。"}
    ]
  }'

7. 常见问题排查

返回鉴权错误

检查 API Key 是否复制完整，是否带有多余空格，是否在「令牌」页面仍处于启用状态。

提示模型不可用

确认模型名称是否和模型广场一致；如果是刚新增渠道，可能需要等待管理员同步配置。

请求频率过高

降低并发、开启重试退避，或联系管理员检查上游渠道额度与速率限制。