认证
authorization string required
所有 API 均使用 Bearer Token 鉴权
获取 API Key:
访问 API Key 管理页面 获取 API Key
用法:
将以下 Header 添加到请求中:
Authorization: Bearer YOUR_API_KEY
参数
model string required
请求使用的模型 ID
值: deepseek-v4-flash
messages array required
表示对话历史的消息对象数组
role
stringrequired消息角色
可选值:
user,assistant,system,developer
content
string | arrayrequired文本字符串或多模态数组
max_tokens integer
生成的最大 token 数量
范围: 1 - 384000
temperature number
采样温度, 值越高输出越随机, 值越低输出越集中和确定
默认值: 1.0
范围: 0.0 - 2.0
top_p number
核采样参数, 可作为温度采样的替代方案
默认值: 1.0
范围: 0.0 - 1.0
stream boolean
是否增量流式返回响应
默认值: false
frequency_penalty number
频率惩罚参数, 用于减少重复 token
默认值: 0.0
范围: -2.0 - 2.0
presence_penalty number
存在惩罚参数, 用于鼓励引入新话题
默认值: 0.0
范围: -2.0 - 2.0
stop string | array
模型停止生成的序列
response_format object
模型输出的格式规范
type
stringrequired输出格式类型
可选值:
text,json_object
tools array
模型可以调用的工具列表
type
stringrequired工具类型
值:
function
function
objectrequired函数定义
tool_choice string | object
控制模型调用哪个工具
可选值: none, auto, required, 或特定工具对象
默认值: auto
响应格式
error object
错误信息, 仅在状态为 failed 时存在
code
string错误码
message
string详细错误信息
output array
生成结果, 仅在状态为 completed 时存在
content
array生成的资源内容列表
type
string资源类型
值:
image|videourl
string处理后的资源 URL
jobId
string远端任务 ID
usage object
使用统计, 仅在状态为 completed 时存在
cost
string总费用(美元)
discount
number折扣金额
metadata object
元数据信息