DeepSeek API 全部参数详细说明

DeepSeek API 参数详细说明

一、请求参数 (Chat Completion)

必需参数

参数名	类型	说明	示例值
`model`	string	指定使用的模型	`"deepseek-chat"`
`messages`	array	消息对象数组	见下方说明

messages 结构

[
  {
    "role": "system",
    "content": "你是一位专业的AI助手"
  },
  {
    "role": "user",
    "content": "请解释量子计算"
  }
]

role: system/user/assistant
content: 消息内容

可选参数

参数名	类型	说明	默认值	范围
`temperature`	float	控制随机性	0.7	0-2
`max_tokens`	int	最大生成token数	2048	1-4096
`top_p`	float	核采样概率	1.0	0-1
`frequency_penalty`	float	频率惩罚	0	-2-2
`presence_penalty`	float	存在惩罚	0	-2-2
`stop`	array/string	停止序列	null	–

二、响应参数

成功响应 (HTTP 200)

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "量子计算是基于量子力学原理..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 120,
    "total_tokens": 135
  }
}

主要字段说明

字段	类型	说明
`id`	string	本次请求的唯一ID
`choices[].message.content`	string	AI生成的内容
`usage.prompt_tokens`	int	输入的token数
`usage.completion_tokens`	int	输出的token数

错误响应

{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

三、完整请求示例

PHP 调用示例

<?php
$data = [
    "model" => "deepseek-chat",
    "messages" => [
        ["role" => "system", "content" => "你是一位科技作家"],
        ["role" => "user", "content" => "写一篇关于AI的短文"]
    ],
    "temperature" => 0.8,
    "max_tokens" => 500];
    
    $response = json_decode($apiCall($data), true);
    
    if(isset($response['choices'][0]['message']['content'])) {
    echo $response['choices'][0]['message']['content'];
    } else {
    echo "错误: ".$response['error']['message'];}
    ?>