在PHP项目中集成AI大模型API时，成本控制是首要考虑的问题。许多开发者误以为调用成本微不足道，仅需使用file_get_contents()或curl_init()发起请求即可，却忽略了按token计费的核心机制，最终导致月度账单远超预期。关键在于准确理解input_tokens（输入令牌）和output_tokens（输出令牌）的计费规则。
当前，OpenAI、Anthropic、阿里云百炼等主流AI服务商均采用token计费模式。一个常见的认知误区是使用PHP内置的strlen()函数估算文本长度，其结果与实际的token数量相差甚远。特别是处理中文内容时，一个汉字可能被模型分词器（Tokenizer）划分为2至4个不等的token，具体数量取决于所选模型的分词算法。
如何进行准确的成本预估？强烈建议使用服务商官方提供的SDK或Tokenizer库（例如OpenAI的tiktoken）进行本地计算。切勿依赖mb_strlen($text, 'UTF8')这类字符计数方法。在开发调试阶段，可以插入如echo "预估消耗tokens: " . $tokenizer->encode($prompt)->count();的代码，对多种典型输入样本进行测试，以掌握token消耗的波动范围。此外，虽然开启流式响应（stream=true）能提升用户体验，但会使得实时token统计变得困难，若非必要，建议在成本敏感场景下关闭此功能。
用cURL发请求时必须设timeout和max_redirects
AI API的响应延迟是常态而非例外。模型负载、网络波动、服务端限流等因素都可能导致curl_exec()长时间阻塞。在PHP-FPM运行模式下，一个未设置超时的请求会挂起整个工作进程，若用户频繁触发，后台并发连接数将急剧上升，进而拖垮服务器性能。
需要明确的是，cURL的默认配置并无超时限制，且通过ini_set('default_socket_timeout', 5)设置的全局超时对其无效，必须通过cURL选项进行显式配置。以下为必须设置的关键参数：
curl_setopt($ch, CURLOPT_TIMEOUT, 8)：设定cURL整体执行超时时间。对于大多数AI接口，5到8秒已足够，不建议超过10秒。curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3)：设定连接建立阶段的超时，可避免在DNS解析或TCP握手环节无休止等待。curl_setopt($ch, CURLOPT_MAXREDIRS, 2)：限制HTTP重定向的最大次数，防止因某些API网关的鉴权跳转而陷入重定向循环。- 务必设置
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true)，以确保curl_exec()将响应内容作为字符串返回，而非直接输出或返回false，这对于后续的错误处理至关重要。
错误码503/429不是代码bug，是预算或配额触顶
当PHP程序接收到HTTP 429（请求过多）或503（服务不可用）状态码时，首要排查方向不应该是增加重试机制，而应立即检查账户的用量配额与预算设置。常见原因包括：免费试用额度已耗尽、账户余额不足、或将API的QPS（每秒查询率）配额设置过低（例如设为5），却在代码中使用了同步循环调用，瞬间触发限流。
