PHP调用DeepSeek API手把手教程：完整流程+避坑指南

我们把调用DeepSeek API的全流程拆成了“能直接跟着做”的步骤：从DeepSeek开发者平台申请密钥（附截图指引）、确认PHP环境的cURL扩展是否开启，到核心代码的逐行编写——怎么构造POST请求的headers（比如必须加的Content-Type）、怎么把prompt和模型参数拼成JSON、怎么解析返回的响应数据（比如提取生成的文本），每一步都给了可复制的示例，连变量名怎么写都标得明明白白。

更实用的是，我们把新手常踩的5个“致命坑”扒得清清楚楚：比如密钥没加“Bearer ”前缀会直接报错、参数里的“max_tokens”填成字符串会导致解析失败、模型名写错会返回“模型不存在”……每个坑都附了具体的错误提示和解决办法，帮你省去“猜问题”的时间。

不管你是想集成AI聊天功能，还是给项目加文本生成、代码辅助能力，跟着这份指南走，不用查零散资料，1小时就能把DeepSeek API在PHP里跑通。现在就翻开，把“不会调用”变成“马上能用”！

做PHP开发的你，是不是想过用DeepSeek API给项目加个AI功能？比如给电商网站做自动商品文案生成、给企业客服系统加智能问答，结果刚上手就卡壳——密钥在哪申请？代码怎么写才不报错？请求发出去没响应，到底是参数错了还是格式不对？明明翻了DeepSeek的官方文档，还是在“小细节”上栽跟头：要么密钥格式不对返回401错误，要么请求头没加Content-Type导致服务器解析失败，要么模型名写错直接提示“模型不存在”，折腾半天还是没跑通，越试越崩溃。

别慌，这篇教程就是帮你“踩平坑、走顺路”的！我去年帮朋友的创业项目对接DeepSeek API时，也踩过一模一样的坑——当时为了找“为什么密钥无效”的原因，翻了3遍文档，最后才发现是没加“Bearer ”前缀（没错，就是Bearer后面加个空格！）；还有一次写代码时把“max_tokens”写成了字符串“100”，结果服务器返回“参数类型错误”，我盯着代码看了20分钟才反应过来。所以这次我把所有踩过的坑、跑通的流程，都拆成了“能直接跟着做”的步骤，连截图指引和可复制的代码都准备好了，就是为了让你不用再走我走过的弯路。

这篇教程的核心就是“手把手”：从DeepSeek开发者平台申请密钥的具体步骤（比如“登录后点左侧‘API密钥’，然后点‘创建新密钥’，记得复制保存，丢了就找不回来了”），到确认PHP环境的cURL扩展是否开启（教你用phpinfo()查看，没开的话怎么在php.ini里改），再到核心代码的逐行讲解——怎么用cURL构造POST请求、怎么设置headers里的Authorization和Content-Type、怎么把prompt和模型参数拼成符合要求的JSON格式、怎么解析返回的响应数据（比如从json里提取“choices”里的生成文本），每一步都给了“能直接复制粘贴”的示例，连变量名我都尽量用得直白（比如$apiKey就是你的密钥，$prompt就是你要给AI的提示词），生怕你看不懂。

更实用的是，我把自己踩过的5个“致命坑”全列出来了：比如密钥必须加“Bearer ”前缀（别漏空格！）、参数里的“max_tokens”得是整数（别写成字符串“100”）、模型名要填“deepseek-chat”而不是“deepseek”（我当初就是写错模型名，浪费了半小时）、请求的JSON里“messages”字段得是数组格式（每个元素要有“role”和“content”）、返回的响应里要检查“code”字段（不是200就是出错了）。每个坑都附了具体的错误提示和解决办法，比如“如果返回401，先检查密钥前面有没有加‘Bearer ’”“如果返回400，看看参数里有没有字符串类型的数字”，直接帮你定位问题。

不管你是PHP新手（只要会写基础的PHP代码），还是有经验的开发者（想快速对接不用查文档），想集成DeepSeek的AI能力，跟着这份指南走就行。不用再翻零散的文档，不用再猜“哪里错了”，我把能踩的坑都替你踩过了，直接照做，1小时就能把DeepSeek API在PHP里跑通。比如你想做个“AI写文案”的功能，跟着教程写完代码，输入prompt“写一段关于猫咪罐头的商品描述，突出‘无谷、高蛋白’”，就能直接拿到AI生成的文案，比自己写快10倍。

现在就翻开教程，把“不会调用”变成“马上能用”——毕竟做开发，最爽的就是“写的代码能跑通”，不是吗？

DeepSeek API密钥在哪里申请？怎么保存？

你可以登录DeepSeek开发者平台，点左侧导航栏的“API密钥”选项，然后点击“创建新密钥”就能生成。生成后一定要马上复制保存好，因为密钥只显示一次，丢了就找不回来了，得重新创建。

PHP调用DeepSeek API时，cURL扩展没开怎么办？

先在PHP文件里写phpinfo();然后访问这个文件，搜索“cURL”看看有没有开启。如果没开，找到PHP安装目录下的php.ini文件，打开后找到“extension=curl”这行，把前面的分号去掉，保存后重启Apache或Nginx服务器，再检查就应该开了。

为什么密钥填了还是返回401错误？

大概率是密钥格式不对——DeepSeek API要求Authorization请求头里的密钥必须加“Bearer ”前缀（注意Bearer后面有个空格）。比如你的密钥是“sk-xxxx”，那请求头里要写成“Bearer sk-xxxx”，漏了空格或者没加Bearer都会导致401验证失败。

参数里的max_tokens填成字符串“100”会有什么问题？

会返回400参数类型错误，因为DeepSeek API要求max_tokens必须是整数类型。你得把代码里的“100”改成100，去掉引号，比如原来写的是”max_tokens”: “100”，要改成”max_tokens”: 100，这样服务器才能正确解析。

返回的响应里怎么提取AI生成的文本？

首先用json_decode把返回的响应字符串转成PHP数组（记得加true参数转成关联数组），然后找choices数组里的内容。比如$response = json_decode($curlResponse, true);生成的文本就在$response[‘choices’][0][‘message’][‘content’]里，直接取这个值就行。

YUANLEISVIP

收藏 链接