Skip to main content

​
欢迎使用花卷智能体 API

花卷智能体提供了一套简洁、强大的 RESTful API,让你轻松集成 AI 对话能力到你的应用中。

​
Base URL

https://huajune.duliday.com/api/v1

​
认证方式

所有 API 请求都需要在 HTTP 请求头中携带 Bearer Token: 
Authorization: Bearer YOUR_API_KEY
详见 认证文档

​
可用端点

POST /chat

发起对话,支持流式输出、工具调用等高级功能

GET /models

获取可用的 AI 模型列表

GET /tools

获取可用工具及其上下文要求

GET /prompt-types

获取系统提示词类型枚举

GET /config-schema

获取配置字段的 Schema 定义

​
API 特性

支持 Server-Sent Events (SSE) 实时返回生成内容,提供打字机效果
AI 可调用 bash、zhipin_reply_generator 等工具完成复杂任务
智能管理对话历史,自动优化 Token 使用,降低成本
灵活的上下文注入机制,支持工具级和全局级配置
支持 Claude、GPT-4、Qwen 等多种主流大语言模型

​
数据格式

​
请求格式

所有 POST 请求使用 JSON 格式: 
Content-Type: application/json

​
响应格式

成功响应: 
{
  "success": true,
  "data": {
    // 响应数据
  }
}
错误响应: 
{
  "error": "ErrorType",
  "message": "Human-readable error message",
  "statusCode": 400,
  "correlationId": "req_abc123"
}
correlationId 说明：
  • 大多数错误（400, 403, 500等）在响应体和响应头中都包含 correlationId
  • 401 认证错误不包含 correlationId（既不在响应体也不在响应头）
详见 错误处理

​
速率限制

当前状态：API 目前未实现速率限制功能,不会返回 429 错误或相关响应头。如需限流,建议在网关层或应用层实现。

​
SDK 和示例

快速开始

5 分钟快速上手指南

完整示例

查看 JavaScript 和 Python 完整示例

​
下一步

1

了解请求/响应格式

查看 请求与响应 详细说明
2

选择端点

从左侧菜单选择你需要的 API 端点
3

查看错误码

参考 错误码表 处理异常情况