智能体 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 | 技能由服务端管理;通常无需在客户端传入工具列表。 |
完整模型列表请查看模型目录。技能在控制台的项目设置中管理,客户端通常无需自行提交工具列表。