简介

Laravel AI SDK 提供了一个统一而富有表现力的 API，用于与 OpenAI、Anthropic、Gemini 等 AI 服务提供商进行交互。借助 AI SDK，您可以构建具备工具支持和结构化输出的智能代理，生成图像、合成与转录音频、创建向量嵌入，以及执行更多操作——所有这些都通过一致且符合 Laravel 风格的接口来完成。

文档

Laravel AI SDK 的文档可在 Laravel 官方网站 上找到。

贡献

感谢您考虑为 Laravel 做出贡献！贡献指南可在 Laravel 文档 中查阅。

行为准则

为确保 Laravel 社区对所有人保持友好与包容，请仔细阅读并遵守 行为准则。

安全漏洞

请参阅 我们的安全政策，了解如何报告安全漏洞。

许可证

Laravel AI SDK 是一款开源软件，采用 MIT 许可证 授权。

Laravel AI SDK 快速上手指南

环境准备

• PHP ≥ 8.2
• Laravel ≥ 11.0
• Composer（建议配置阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/）

安装步骤

# 1. 进入项目根目录
cd your-laravel-project

# 2. 安装 SDK（使用国内镜像）
composer config repositories.packagist composer https://mirrors.aliyun.com/composer/
composer require laravel/ai

# 3. 发布配置文件（可选）
php artisan vendor:publish --provider="Laravel\Ai\AiServiceProvider"

基本使用

use Illuminate\Support\Facades\Ai;

// 1. 文本生成
$response = Ai::text('openai')->prompt('用中文介绍 Laravel')->generate();
echo $response->text();   // 输出生成的文本

// 2. 图片生成
$image = Ai::image('openai')->prompt('一只可爱的猫')->generate();
echo $image->url();       // 输出生成图片的 URL

// 3. 向量嵌入
$embedding = Ai::embedding('openai')->text('Laravel 是一个优雅的 PHP 框架')->generate();
print_r($embedding->vector());

首次使用需在 .env 中配置对应 AI 服务的 API Key，例如：
OPENAI_API_KEY=sk-xxx