Skip to main content
POST
Chat接口(Detail=False Stream=True)

概述

聊天接口是AI Gateway的核心功能,支持多种AI Agent(如FastGPT和Dify)的统一调用。该接口支持流式传输和详细输出模式。

认证方式

该接口需要以下认证信息:

Header参数

string
required
使用的后端Agent名称,例如:fastgptdify
string
required
API密钥,格式为:Bearer your_api_key

请求参数

请求体

string
required
对于FastGPT来说,这是必填项。应用的唯一标识符。
string
required
对话ID,用来控制对话的上下文。
boolean
required
是否启用流式传输。设置为true时,响应将以流式形式返回。
boolean
required
是否输出详细内容。设置为true时,将返回更详细的响应信息。
string
required
用户输入的查询内容。
string
required
用于Dify的上下文控制。对于Dify Agent,这是必填项。
array
required
文件URL列表,用于上传文件到对话中。

响应示例

成功响应

使用示例

基本聊天请求

流式响应请求

注意事项

  1. Agent选择:根据您的需求选择合适的Agent(fastgptdify
  2. 参数验证:确保所有必填参数都已正确提供
  3. 流式传输:启用流式传输时,客户端需要正确处理SSE(Server-Sent Events)
  4. 文件上传:上传文件时,确保文件URL是公开可访问的
  5. 上下文管理:合理使用chat_idconversation_id来维护对话上下文

Headers

Agent
string
required

使用的后端Agent

Authorization
string
required

申请的 api_key

Body

application/json
app_id
string
required

对于FastGPT来说,这是必填项

chat_id
string
required

用来控制对话的上下文

stream
boolean
required

用来控制是否启用流式传输

detail
boolean
required

是否输出详细内容

query
string
required
conversation_id
string
required

用来控制Dify的上下文

files
string[]
required

Response

200 - application/json
object
string
required
created
integer
required
model
string
required
choices
object[]
required
id
string