Download the PHP package larva/laravel-ai-volc without Composer
On this page you can find all versions of the php package larva/laravel-ai-volc. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download larva/laravel-ai-volc
More information about larva/laravel-ai-volc
Files in larva/laravel-ai-volc
Package laravel-ai-volc
Short Description Volcengine Ark (火山方舟) provider for Laravel AI: text, embeddings, TTS, Seedream images and Seedance video.
License MIT
Informations about the package laravel-ai-volc
Laravel AI · 火山方舟(Volcengine Ark)驱动
为 Laravel AI 提供火山引擎方舟平台(Volcengine Ark)接入驱动,在官方 openai-compatible 驱动的文本对话 / 向量能力之上,补齐方舟平台的多模态扩展能力:
- 💬 文本对话 / 向量嵌入:继承官方 OpenAI 兼容驱动(豆包大模型)
- 🔊 TTS 语音合成:对接 OpenAI 兼容的
/audio/speech端点(doubao-seed-tts) - 🎨 Seedream 图像生成:对接 OpenAI 兼容的
/images/generations端点(doubao-seedream) - 🎬 Seedance 视频生成:异步任务模式(创建任务 → 轮询结果)
环境需求
- PHP
^8.4 - Laravel
^12.0/^13.0 laravel/ai^0.10.3- 火山方舟 API Key(控制台获取)
安装
包通过 Laravel Package Discovery 自动注册 volc 驱动,无需手动添加 ServiceProvider。
配置
在 config/ai.php 的 providers 中新增火山方舟接入点:
.env:
如需将火山方舟设为默认提供方:
使用
文本对话 / 向量嵌入
文本与向量能力继承自官方 OpenAI 兼容驱动,用法与 Laravel AI 官方文档 一致,将提供方指定为 volc 即可:
TTS 语音合成
SDK 占位音色 default-female / default-male 会映射为配置中的 voice / male_voice;也可以直接传入方舟音色 ID:
方舟不支持 OpenAI 的
instructions参数,情绪 / 语气通过音色与提示文本控制。
Seedream 图像生成
尺寸与质量映射规则:显式 size(支持 1:1 / 2:3 / 3:2 比例或 1536x1024 显式像素)优先;未指定时 quality 映射为方舟分辨率档位(low → 1K、medium → 2K、high → 4K)。
Seedance 视频生成
视频生成为方舟异步任务接口(SDK 暂无 VideoProvider 契约),由 VolcProvider 直接提供:
任务 ID 仅保存 7 天,生成完成后请及时下载视频。
异常处理
网关统一使用 Laravel AI 的异常体系,可在调用处捕获:
Laravel\Ai\Exceptions\RateLimitedException:触发限流Laravel\Ai\Exceptions\InsufficientCreditsException:余额不足Laravel\Ai\Exceptions\ProviderOverloadedException:服务过载Illuminate\Http\Client\RequestException:其它 HTTP 错误
开发与测试
贡献
欢迎提交 Issue 与 Pull Request。提交前请:
- 通过
composer test全部测试 - 通过
composer check-style风格检查 - 在 PR 中描述清楚变更背景与影响范围
安全
如发现安全漏洞,请联系:[email protected],请勿在公开 Issue 中披露。
许可证
本项目基于 MIT 协议发布。

