第1章 Ojin 快速上手：无代码部署与 SDK 自定义双路径指南

完整文档索引见 llms.txt。此页也可获取为 Markdown 格式。

快速上手

几分钟内让 Ojin 跑起来。

本指南覆盖两种实现路径：要么使用无代码的 Human Agent 应用部署完整的对话智能体，要么使用 Python SDK 从自定义流水线中驱动实时面部模型。

选择你的路径

Ojin 提供两种构建实时 AI 的方式，可从更适合的一种开始：

1. 部署 Human Agent（无代码，最快）
   部署具备可视化虚拟形象的内嵌对话式 AI 智能体。Ojin 处理完整流水线，你也可以带入自己的语音到语音（speech-to-speech）服务商。无需组装流水线。无需 API key：你在仪表盘中构建智能体，网页小部件会直接与 Ojin 通信。
   
   1. 在仪表盘中创建并配置你的智能体
   2. 将小部件嵌入你的网站。只需一个 HTML 标签，搞定。
2. 使用 SDK 构建。自定义流水线
   在你的自有对话流水线中，使用 Ojin 的实时面部模型作为可视化虚拟形象层。你控制全栈：STT、LLM、TTS，并通过 Python SDK 或 Pipecat 将 TTS 音频转化为同步说话的虚拟形象。选择 ojin/human-presence（旗舰）或 ojin/human-portrait（高性价比）及其 config_id。
   
   1. 从 Ojin 仪表盘获取你的 API key。此路径从你的后端调用 Ojin，因此需要 API key。
   2. 使用 Python SDK 构建，安装、鉴权并流式传输你的首个虚拟形象。
   3. 或将虚拟形象集成到 Pipecat 语音智能体中。

切勿将 API key 硬编码在应用代码中，或将其提交到版本控制系统。

故障排查

遇到麻烦？查阅故障排查指南或联系支持团队。

后续步骤

1. 使用 Python SDK 构建
   安装、鉴权，并流式传输你的首个虚拟形象。
2. Human Agent
   了解完整的智能体产品详情。

上一篇：欢迎
下一篇：获取 API key
最后更新：26 天前

此内容有帮助吗？