飞桥数智云/文档

智能体 API 使用 OpenAI 兼容的 Chat Completions 请求格式。项目使用控制台中配置的模型、系统提示词和托管技能。

接口

POST https://api.feiqiao.ai/v1/chat/completions

请求头:

Authorization: Bearer <飞桥 API 密钥>
Content-Type: application/json

请求示例

curl https://api.feiqiao.ai/v1/chat/completions \
  -H "Authorization: Bearer $FEIQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "managed",
    "messages": [
      { "role": "user", "content": "你好,请介绍一下你能做什么。" }
    ]
  }'

model 字段可省略;如填写,建议使用 managed。实际模型由项目设置决定。messages 至少包含一条消息,可使用 system、user、assistant 或 tool 角色。

常用参数

参数 类型 说明
model string 可选;建议设置为 managed,由项目配置选择模型。
messages array 对话消息数组,必填。
stream boolean 是否以流式方式接收回复。
temperature number 采样温度,范围为 0 到 2。
top_p number 核采样参数,范围为 0 到 1。
max_completion_tokens integer 限制生成内容的最大 token 数。
tools array 技能由服务端管理;通常无需在客户端传入工具列表。

完整模型列表请查看模型目录。技能在控制台的项目设置中管理,客户端通常无需自行提交工具列表。