client

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• PHP 环境（README 节选未标注最低版本，请以仓库安装章节为准）
• Composer 依赖管理工具
• 可用的 API 密钥（示例 sk-xxxxxxxx）
• 一个已创建好的助手 ID（形如 asst_ 开头）

安装与启动步骤

1. 1准备 PHP 与 Composer

   确认本机已装 PHP 与 Composer，在项目根目录执行 composer --version 能输出版本号即可。

   composer --version

   复制

2. 2安装 SDK 依赖

   通过 Composer 引入 openai-php/client 包（包名取自 README 的 Packagist 徽章），具体版本约束以仓库为准。

   composer require openai-php/client

   复制

3. 3初始化客户端

   在 PHP 脚本中引入 Composer 自动加载文件，并用你的 API 密钥构造客户端实例后再调用资源方法。

   <?php
   require __DIR__ . '/vendor/autoload.php';
   
   // 使用你的 API 密钥初始化客户端
   $client = OpenAI::client('sk-xxxxxxxx');

   复制

4. 4调用 createAndRun

   用一次请求创建会话线程并运行，需传入助手 ID 和至少一条用户消息，消息为 role/content 结构。

   <?php
   $response = $client->threads()->createAndRun(
       [
           'assistant_id' => 'asst_gxzBkD1wkKEloYqZ410pT5pd',
           'thread' => [
               'messages' => [
                   [
                       'role' => 'user',
                       'content' => 'Explain deep learning to a 5 year old.',
                   ],
               ],
           ],
       ],
   );

   复制

5. 5读取响应字段

   返回对象可直接读取 id、status、model、usage 等属性，也可用 toArray() 转成数组便于存储或输出。

   echo $response->id;
   echo $response->status;
   print_r($response->toArray());

   复制

关键配置

如何确认成功

脚本运行后输出以 run_ 开头的 id，且 status 为 queued，说明请求已被接口接受。

常见问题

注意事项

• README 节选未包含安装章节与客户端初始化代码，本教程的安装与初始化步骤依据 Packagist 包名和示例调用方式推断，请以仓库完整文档核对。
• Assistants 相关资源已被官方标记弃用并有停服日期，新项目建议使用 README 推荐的替代接口。
• 示例中的助手 ID 与密钥均为占位示例，务必替换为自己的真实值，密钥不要写入版本库。