n8n-nodes-doubao-api/README.md

n8n节点 - 豆包大模型API调用

# n8n-nodes-doubao-api

这是一个 n8n 社区节点，用于调用豆包大模型 API，实现人工智能对话和内容生成。

## 安装

在 n8n 项目目录中执行以下命令安装此节点：

```bash
npm install n8n-nodes-doubao-api
```

或者在 n8n 界面中，通过 `设置` -> `社区节点` 进行安装。

## 功能

- 支持 `doubao-1.5-pro-32k-250115` 和 `doubao-1.5-7b-Chat` 模型
- 可自定义系统提示词和用户提示词
- 支持请求超时设置和自动重试
- 完全符合豆包 API 的请求和响应格式

## 使用方法

1. 在 n8n 中创建一个工作流
2. 添加"豆包 API"节点
3. 配置节点参数：
   - 认证方式：选择 API Key
   - 模型：选择要使用的豆包模型
   - 系统提示词：设置 AI 的角色和行为
   - 用户提示词：与系统提示词组合使用，引导AI进行回答
   - 用户输入：实际需要 AI 回答的内容
   - 选项（可选）：
     - 超时时间：API 请求超时设置，默认 30 秒
     - 最大重试次数：请求失败时重试次数，默认 3 次

## 凭证设置

使用此节点需要设置豆包 API 凭证：

1. 在 n8n 中进入 `凭证` 页面
2. 点击 `添加凭证` 按钮
3. 选择 `豆包 API` 类型
4. 输入在豆包官网获取的 API Key

## 输出数据

节点执行成功后，输出的 JSON 数据格式如下：

```json
{
  "content": "AI生成的回复内容",
  "model": "使用的模型名称",
  "created": 1234567890,
  "id": "请求ID",
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 10,
    "total_tokens": 25
  }
}
```

## 注意事项

- 豆包 API 请求需要将系统提示词和用户提示词组合到一起
- API 请求需要有效的豆包账户和足够的使用额度
- 确保网络环境能够正常访问豆包 API 服务

## 常见问题

### API 调用失败怎么办？

- 检查 API Key 是否正确
- 检查网络连接是否正常
- 确认豆包账户有足够的使用额度
- 查看错误日志了解详细错误信息

### 如何优化响应结果？

- 优化系统提示词和用户提示词
- 提供更清晰、具体的用户输入
- 针对不同场景选择适合的模型