一、DeepSeek API 概述

DeepSeek API 是提供自然语言处理（NLP）、计算机视觉（CV）等AI能力的开放接口，开发者可通过HTTP请求调用模型推理、文本生成、图像识别等功能。其核心优势在于：

1. 高兼容性：支持RESTful API设计，兼容JSON/Protobuf等数据格式。
2. 低延迟：通过分布式计算优化，响应时间控制在毫秒级。
3. 弹性扩展：按需调用模型资源，避免自建算力成本。

对于PHP开发者而言，调用DeepSeek API可快速实现智能客服、内容审核、数据分析等场景，无需深入底层算法。

二、PHP调用DeepSeek API的准备工作

1. 环境配置要求

• PHP版本：建议使用PHP 7.4+（支持cURL扩展）。
• 依赖库：
  • cURL：用于发送HTTP请求。
  • JSON：解析API返回的JSON数据。
  • 安装命令：sudo apt install php-curl php-json（Linux）或通过XAMPP/WAMP配置。

2. 获取API密钥

1. 登录DeepSeek开发者平台。
2. 创建项目并生成API Key和Secret Key。
3. 启用所需API服务（如文本生成、图像识别）。

安全提示：密钥需存储在环境变量或加密配置文件中，避免硬编码在代码中。

三、PHP调用DeepSeek API的核心步骤

1. 构建HTTP请求

基础请求结构

<?php
$apiKey = getenv('DEEPSEEK_API_KEY'); // 从环境变量获取密钥
$endpoint = 'https://api.deepseek.com/v1/text/generate'; // API地址
$data = [
    'prompt' => '生成一篇关于PHP的教程',
    'max_tokens' => 100,
    'temperature' => 0.7
];
$options = [
    CURLOPT_URL => $endpoint,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($data),
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer ' . $apiKey
    ]
];
$ch = curl_init();
curl_setopt_array($ch, $options);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
print_r($result);
?>

关键参数说明

• prompt：输入文本（如问题、指令）。
• max_tokens：生成文本的最大长度。
• temperature：控制输出随机性（0.1~1.0，值越高越创意）。

2. 处理API响应

DeepSeek API通常返回以下结构：

{
    "status": "success",
    "data": {
        "text": "PHP是一种流行的服务器端脚本语言...",
        "tokens_used": 45
    },
    "error": null
}

PHP代码需检查status字段并处理错误：

if ($result['status'] === 'success') {
    echo $result['data']['text'];
} else {
    throw new Exception("API Error: " . $result['error']['message']);
}

3. 错误处理与重试机制

常见错误类型

• 401 Unauthorized：密钥无效或过期。
• 429 Too Many Requests：超过调用频率限制。
• 500 Internal Error：服务端异常。

实现重试逻辑

function callDeepSeekApi($data, $maxRetries = 3) {
    $apiKey = getenv('DEEPSEEK_API_KEY');
    $endpoint = 'https://api.deepseek.com/v1/text/generate';
    for ($i = 0; $i < $maxRetries; $i++) {
        $ch = curl_init();
        // ...设置cURL选项（同上）
        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        if ($httpCode === 200) {
            return json_decode($response, true);
        } elseif ($i < $maxRetries - 1) {
            sleep(2); // 指数退避
        } else {
            throw new Exception("API调用失败，HTTP码: $httpCode");
        }
    }
}

四、高级功能实现

1. 异步调用与批量处理

通过并发请求提升效率：

$mh = curl_multi_init();
$handles = [];
$prompts = [
    ['prompt' => 'PHP历史', 'max_tokens' => 50],
    ['prompt' => 'PHP未来趋势', 'max_tokens' => 50]
];
foreach ($prompts as $i => $prompt) {
    $ch = curl_init('https://api.deepseek.com/v1/text/generate');
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => json_encode($prompt),
        CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'Authorization: Bearer ' . $apiKey]
    ]);
    curl_multi_add_handle($mh, $ch);
    $handles[$i] = $ch;
}
$running = null;
do {
    curl_multi_exec($mh, $running);
    curl_multi_select($mh);
} while ($running > 0);
$results = [];
foreach ($handles as $i => $ch) {
    $results[$i] = json_decode(curl_multi_getcontent($ch), true);
    curl_multi_remove_handle($mh, $ch);
}
curl_multi_close($mh);

2. 安全优化

• HTTPS强制：确保API端点使用https://。
• 输入验证：过滤用户输入的prompt，防止注入攻击。
• 日志记录：记录API调用日志（需脱敏敏感信息）。

五、实战案例：智能问答系统

1. 系统架构

用户输入 → PHP后端 → DeepSeek API → 返回答案 → 渲染页面

2. 完整代码示例

<?php
// 配置
$apiKey = getenv('DEEPSEEK_API_KEY');
$endpoint = 'https://api.deepseek.com/v1/text/generate';
// 处理用户请求
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $question = trim($_POST['question']);
    if (!empty($question)) {
        try {
            $response = callDeepSeekApi([
                'prompt' => "用户问题: $question\n回答:",
                'max_tokens' => 200
            ]);
            $answer = $response['data']['text'];
        } catch (Exception $e) {
            $answer = "服务暂时不可用，请稍后再试。";
        }
    }
}
?>
<!-- 前端表单 -->
<form method="post">
    <input type="text" name="question" placeholder="输入问题" required>
    <button type="submit">提问</button>
</form>
<?php if (isset($answer)): ?>
    <div class="answer"><?= htmlspecialchars($answer) ?></div>
<?php endif; ?>

六、常见问题解答

1. Q：调用频率限制是多少？
   A：默认每分钟100次，可通过开发者平台申请提升配额。

2. Q：如何降低API成本？
   A：优化max_tokens参数，避免生成冗余内容；使用缓存存储重复问题答案。

3. Q：PHP 7.2能否调用？
   A：建议升级至7.4+，旧版本可能缺少JSON扩展或cURL支持。

七、总结与展望

通过本文，开发者已掌握PHP调用DeepSeek API的全流程，包括环境配置、请求封装、错误处理及高级功能。未来可探索：

• 结合Laravel/Symfony框架封装SDK。
• 集成WebSocket实现实时对话。
• 使用Prometheus监控API调用指标。

DeepSeek API的灵活性为PHP应用赋予了强大的AI能力，助力开发者快速构建智能化解决方案。