API 参考

概述
认证
错误码

核心端点

执行指令
批量执行
指令管理

高级功能

模型微调
流式响应

度飞飞AI指令合成API

当前版本：v2.5.1 API使用条款 · 更新日志

概述

度飞飞API提供程序化访问AI指令合成能力的接口，支持：

  • 单次/批量指令执行
  • 自定义prompt模板管理
  • 模型参数实时调整
  • 流式结果返回
基础URL： https://api.dufeifei.com/v2
所有请求必须使用HTTPS协议，默认返回JSON格式数据

认证

使用API密钥进行身份验证，需在请求头中添加：

Authorization: Bearer YOUR_API_KEY

密钥管理：

  • 每个账号最多创建5个API密钥
  • 密钥需定期轮换（建议每90天）
  • 泄露的密钥应立即撤销

执行指令

POST /prompt/execute

执行单个AI指令并返回生成结果

请求参数

参数 类型 必填 说明
prompt string 是 指令文本（最长4000字符）
model string 否 模型ID（默认：df-pro-5）
temperature float 否 创意度（0.1-2.0，默认0.7）
max_tokens integer 否 最大生成长度（默认500）

示例请求

// cURL示例 curl -X POST https://api.dufeifei.com/v2/prompt/execute \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "prompt": "用表格形式总结2025年AI领域三大趋势", "model": "df-pro-5", "temperature": 0.8 }'

响应示例

{ "id": "gen_5GxK9pLm", "object": "completion", "created": 1735032000, "model": "df-pro-5", "usage": { "prompt_tokens": 28, "completion_tokens": 215, "total_tokens": 243 }, "output": "| 趋势 | 描述 | 代表技术...", "finish_reason": "length" }

错误码

HTTP状态码 错误码 说明
400 invalid_request 请求参数缺失或格式错误
401 authentication_failed API密钥无效或过期
429 rate_limit_exceeded 超过请求频率限制
500 server_error 服务器内部错误

更新日志

v2.5.1 (2025-12-24)

  • 新增模型参数 top_p 控制采样范围
  • 优化流式响应延迟（降低30%）
  • 修复批量执行时的上下文污染问题