php可用curl向qwen4-max的openai兼容chat completions端点发送json,再从choices[0].message.content读取文本。下面使用新加坡按量api:先准备对应地区的dashscope_api_key,模型名填qwen4-max,并关闭思考以展示最小文本调用;token plan的key和端点不能直接混用。
准备PHP与对应地区的密钥
示例需要PHP 8.1及以上、cURL和JSON支持。密钥由运行进程的环境变量提供,不写进PHP源文件、不发到浏览器。使用其他地区时,同时替换端点与该地区创建的Key。

官方文档中的思考参数和输出预算
<?php $key = getenv('DASHSCOPE_API_KEY');
if (!$key) { throw new RuntimeException('缺少DASHSCOPE_API_KEY'); }
$url = 'https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1/chat/completions';
$payload = [
'model' => 'qwen4-max',
'messages' => [['role' => 'user', 'content' => '用三句话解释PHP依赖注入。']],
'enable_thinking' => false,
'max_completion_tokens' => 512,
];
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Authorization: Bearer '.$key,
],
CURLOPT_POSTFIELDS => json_encode($payload, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE),
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 120,
]);
$raw = curl_exec($ch);
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);
curl_close($ch);
if ($raw === false) { throw new RuntimeException('网络请求失败:'.$error); }
$data = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
if ($status = 300) {
$message = $data['error']['message'] ?? '接口拒绝请求';
throw new RuntimeException('HTTP '.$status.':'.$message);
}
$text = $data['choices'][0]['message']['content'] ?? null;
if (!is_string($text)) { throw new RuntimeException('返回结果中没有文本content'); }
echo $text, PHP_EOL;
分别处理网络失败、接口拒绝与结果缺失
把代码保存为qwen.php,在已设置环境变量的终端执行php qwen.php。网络失败时先查看cURL错误;HTTP 401优先核对Key是否属于当前地区、是否误用了Token Plan凭据;模型不可用时核对正式模型标识及地区开放范围。不要把含密钥的请求头写进错误日志。

官方文档中的Key、端点与地区错误说明
429或服务端错误应按实际响应安排有界重试和退避,不要对所有错误无限重发。程序已收到完整回答、但调用方等待超时等不确定情况,应保留请求关联信息再决定是否重试,重复请求可能产生额外计费。
思考与输出预算按任务选择
模型默认启用思考。此例用enable_thinking=false关闭;若开启,max_completion_tokens同时限制思考和最终回答,需要给两部分留预算,并按接口要求处理推理历史。本文使用Chat Completions路径,不能把同一请求体直接发送到DashScope文本端点;Qwen4-Max在DashScope中使用多模态端点。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











