自托管 Cap 时如何配置 AI_PROVIDER 等环境变量启用转写和 AI 功能【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap按仓库文档自托管 Cap Web 后默认只有上传、分享和媒体处理能力可用转写和 AI 功能需要自行配置对应的 API 密钥与提供方变量。本文基于仓库的自托管文档给出在 Docker Compose 部署上启用视频转写transcript和 AI 功能标题、摘要、章节、转写翻译、docs Ask AI的完整配置路径并说明如何验证功能生效。前置条件启动实例并准备 API 密钥官方自托管快速启动只需三步见 self-hosting.mdxgit clone https://gitcode.com/GitHub_Trending/cap1/Cap cd Cap docker compose up -d启动后 Cap Web 在http://localhost:3000可用组件包括 Cap Web 应用、Media serverFFmpeg 处理、MySQL 和 MinIO。注意主docker-compose.yml会从源码构建 media server因此需要完整克隆仓库。配置 AI 变量前先准备好提供方密钥。文档列出的相关变量变量用途ASSEMBLY_API_KEY转写transcriptionGROQ_API_KEYAI 功能OPENAI_API_KEYAI 功能ANTHROPIC_API_KEYAI 功能这些变量在 packages/env/server.ts 中均为可选项ASSEMBLY_API_KEY描述为 Audio transcriptionANTHROPIC_API_KEY描述为 AI chatOPENAI_API_KEY和GROQ_API_KEY描述为 AI summaries。只配置你实际使用的密钥即可。最简配置依赖自动检测未设置AI_PROVIDER时Cap 会根据现有密钥自动检测提供方且两类功能的优先级不同生成功能标题、摘要、章节、转写翻译Groq → OpenAI → Anthropic聊天功能support messenger 和 docs Ask AIAnthropic → OpenAI → Groq。排序靠前的提供方优先靠后的作为自动回退。因此最短路径是在部署中放入ASSEMBLY_API_KEY和任意一个 AI 密钥不设置AI_PROVIDER转写与 AI 功能即按上述优先级工作。用 AI_PROVIDER 显式选择提供方需要明确指定提供方时设置AI_PROVIDER。合法取值由 packages/env/server.ts 中的枚举定义为assemblyaiopenaianthropicgroqopenai-compatible显式指定后其他已配置的提供方不会失效仍保留在链中作为回退。assemblyai一个密钥同时覆盖转写和 AIAI_PROVIDERassemblyaiassemblyai通过 AssemblyAI LLM Gateway 复用已有的ASSEMBLY_API_KEY一个密钥同时覆盖转写和 AI 功能。文档明确说明该提供方永远不会被自动检测纯转写实例不会在未经显式选择时开始产生 LLM 费用而一旦选择LLM token 会与转写一起计入同一个 AssemblyAI 账户的账单。openai-compatible接入 Ollama、OpenRouter 等端点openai-compatible可对接任何 OpenAI 兼容端点文档举例 Ollama、OpenRouter 或 LM Studio。它要求提供AI_BASE_URL和AI_MODELAI_API_KEY仅在端点需要时提供。以下代码块为文档示例地址和模型名需按你的实际端点替换AI_PROVIDERopenai-compatible AI_BASE_URLhttp://localhost:11434/v1 AI_MODELllama3.3 AI_API_KEYyour-key # 仅当端点要求时按角色覆盖模型与 AssemblyAI EU 网关每个提供方都有默认模型可针对AI_PROVIDER选中的提供方按角色覆盖your-model替换为你实际使用的模型名AI_MODELyour-model # 生成标题、摘要、章节、翻译 AI_CHAT_MODELyour-model # 支持聊天 AI_STREAM_MODELyour-model # 流式 docs Ask AI使用 AssemblyAI EU 网关时AI_BASE_URLhttps://llm-gateway.eu.assemblyai.com/v1EU 网关只提供 Claude 和 Gemini 模型因此还必须覆盖AI_MODEL和AI_STREAM_MODEL——这两个变量的默认值是 OpenAI 系模型仅限美国区使用。让变量真正进入 cap-web 容器自托管文档给出的定制方式是在仓库根目录创建.env文件写入配置值文档以CAP_URL、端口和密码为例。但有一个需要核实的点仓库当前的 docker-compose.yml 中cap-web服务的environment块只转发了数据库、S3、邮件、OAuth 和 media server 相关变量未列出上述任何 AI 变量Docker Compose 只会把文件中引用的变量注入容器。因此需要在你部署所用的 compose 文件里为cap-web服务的environment追加所需变量写法沿用文件内既有的${变量:-}格式如文件中已有的RESEND_API_KEY: ${RESEND_API_KEY:-}# docker-compose.ymlcap-web 服务的 environment 块中追加 ASSEMBLY_API_KEY: ${ASSEMBLY_API_KEY:-} GROQ_API_KEY: ${GROQ_API_KEY:-} OPENAI_API_KEY: ${OPENAI_API_KEY:-} ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-} AI_PROVIDER: ${AI_PROVIDER:-} AI_BASE_URL: ${AI_BASE_URL:-} AI_MODEL: ${AI_MODEL:-} AI_CHAT_MODEL: ${AI_CHAT_MODEL:-} AI_STREAM_MODEL: ${AI_STREAM_MODEL:-} AI_API_KEY: ${AI_API_KEY:-}按实际使用追加对应行即可具体值写入.env如ASSEMBLY_API_KEY你的 AssemblyAI 密钥或内联写入。修改完成后重新执行启动命令让服务应用新环境docker compose up -d验证功能是否生效文档没有为 AI 功能提供专门的健康检查命令可用的验证手段有两个用文档Troubleshooting一节给出的命令查看启动日志确认服务正常docker compose logs cap-web端到端验证用 Cap Desktop 以 Instant 模式录制一段短视频并停止打开返回的分享链接。按 Instant Mode 文档字幕、转写、摘要、章节等内容只在内容已生成、且 Cap 或组织设置允许时出现Quickstart 也提醒这些 AI 字段取决于录制、处理状态、计划和组织设置不要在上传后立刻假设每个 AI 字段都已就位。边界与下一步只配ASSEMBLY_API_KEY而不设AI_PROVIDERassemblyai时实例保持纯转写不会开始产生 LLM 费用这是文档设计的默认行为。仓库docker-compose.yml内置的占位密钥NEXTAUTH_SECRET、DATABASE_ENCRYPTION_KEY、MEDIA_SERVER_WEBHOOK_SECRET只适合本地测试公开部署前必须按自托管文档的 Production Checklist 生成并替换。全部可用环境变量的定义参考 packages/env/server.ts。如果你使用 Coolify 而非主 compose 文件注意其 compose 文件使用不同的变量名WEB_URL代替CAP_URL、S3_PUBLIC_ENDPOINT代替S3_PUBLIC_URL按自托管文档在 Coolify UI 中配置AI 变量同样需要在 Coolify 的项目环境中显式提供。【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
自托管 Cap 时如何配置 AI_PROVIDER 等环境变量启用转写和 AI 功能？
自托管 Cap 时如何配置 AI_PROVIDER 等环境变量启用转写和 AI 功能【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap按仓库文档自托管 Cap Web 后默认只有上传、分享和媒体处理能力可用转写和 AI 功能需要自行配置对应的 API 密钥与提供方变量。本文基于仓库的自托管文档给出在 Docker Compose 部署上启用视频转写transcript和 AI 功能标题、摘要、章节、转写翻译、docs Ask AI的完整配置路径并说明如何验证功能生效。前置条件启动实例并准备 API 密钥官方自托管快速启动只需三步见 self-hosting.mdxgit clone https://gitcode.com/GitHub_Trending/cap1/Cap cd Cap docker compose up -d启动后 Cap Web 在http://localhost:3000可用组件包括 Cap Web 应用、Media serverFFmpeg 处理、MySQL 和 MinIO。注意主docker-compose.yml会从源码构建 media server因此需要完整克隆仓库。配置 AI 变量前先准备好提供方密钥。文档列出的相关变量变量用途ASSEMBLY_API_KEY转写transcriptionGROQ_API_KEYAI 功能OPENAI_API_KEYAI 功能ANTHROPIC_API_KEYAI 功能这些变量在 packages/env/server.ts 中均为可选项ASSEMBLY_API_KEY描述为 Audio transcriptionANTHROPIC_API_KEY描述为 AI chatOPENAI_API_KEY和GROQ_API_KEY描述为 AI summaries。只配置你实际使用的密钥即可。最简配置依赖自动检测未设置AI_PROVIDER时Cap 会根据现有密钥自动检测提供方且两类功能的优先级不同生成功能标题、摘要、章节、转写翻译Groq → OpenAI → Anthropic聊天功能support messenger 和 docs Ask AIAnthropic → OpenAI → Groq。排序靠前的提供方优先靠后的作为自动回退。因此最短路径是在部署中放入ASSEMBLY_API_KEY和任意一个 AI 密钥不设置AI_PROVIDER转写与 AI 功能即按上述优先级工作。用 AI_PROVIDER 显式选择提供方需要明确指定提供方时设置AI_PROVIDER。合法取值由 packages/env/server.ts 中的枚举定义为assemblyaiopenaianthropicgroqopenai-compatible显式指定后其他已配置的提供方不会失效仍保留在链中作为回退。assemblyai一个密钥同时覆盖转写和 AIAI_PROVIDERassemblyaiassemblyai通过 AssemblyAI LLM Gateway 复用已有的ASSEMBLY_API_KEY一个密钥同时覆盖转写和 AI 功能。文档明确说明该提供方永远不会被自动检测纯转写实例不会在未经显式选择时开始产生 LLM 费用而一旦选择LLM token 会与转写一起计入同一个 AssemblyAI 账户的账单。openai-compatible接入 Ollama、OpenRouter 等端点openai-compatible可对接任何 OpenAI 兼容端点文档举例 Ollama、OpenRouter 或 LM Studio。它要求提供AI_BASE_URL和AI_MODELAI_API_KEY仅在端点需要时提供。以下代码块为文档示例地址和模型名需按你的实际端点替换AI_PROVIDERopenai-compatible AI_BASE_URLhttp://localhost:11434/v1 AI_MODELllama3.3 AI_API_KEYyour-key # 仅当端点要求时按角色覆盖模型与 AssemblyAI EU 网关每个提供方都有默认模型可针对AI_PROVIDER选中的提供方按角色覆盖your-model替换为你实际使用的模型名AI_MODELyour-model # 生成标题、摘要、章节、翻译 AI_CHAT_MODELyour-model # 支持聊天 AI_STREAM_MODELyour-model # 流式 docs Ask AI使用 AssemblyAI EU 网关时AI_BASE_URLhttps://llm-gateway.eu.assemblyai.com/v1EU 网关只提供 Claude 和 Gemini 模型因此还必须覆盖AI_MODEL和AI_STREAM_MODEL——这两个变量的默认值是 OpenAI 系模型仅限美国区使用。让变量真正进入 cap-web 容器自托管文档给出的定制方式是在仓库根目录创建.env文件写入配置值文档以CAP_URL、端口和密码为例。但有一个需要核实的点仓库当前的 docker-compose.yml 中cap-web服务的environment块只转发了数据库、S3、邮件、OAuth 和 media server 相关变量未列出上述任何 AI 变量Docker Compose 只会把文件中引用的变量注入容器。因此需要在你部署所用的 compose 文件里为cap-web服务的environment追加所需变量写法沿用文件内既有的${变量:-}格式如文件中已有的RESEND_API_KEY: ${RESEND_API_KEY:-}# docker-compose.ymlcap-web 服务的 environment 块中追加 ASSEMBLY_API_KEY: ${ASSEMBLY_API_KEY:-} GROQ_API_KEY: ${GROQ_API_KEY:-} OPENAI_API_KEY: ${OPENAI_API_KEY:-} ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-} AI_PROVIDER: ${AI_PROVIDER:-} AI_BASE_URL: ${AI_BASE_URL:-} AI_MODEL: ${AI_MODEL:-} AI_CHAT_MODEL: ${AI_CHAT_MODEL:-} AI_STREAM_MODEL: ${AI_STREAM_MODEL:-} AI_API_KEY: ${AI_API_KEY:-}按实际使用追加对应行即可具体值写入.env如ASSEMBLY_API_KEY你的 AssemblyAI 密钥或内联写入。修改完成后重新执行启动命令让服务应用新环境docker compose up -d验证功能是否生效文档没有为 AI 功能提供专门的健康检查命令可用的验证手段有两个用文档Troubleshooting一节给出的命令查看启动日志确认服务正常docker compose logs cap-web端到端验证用 Cap Desktop 以 Instant 模式录制一段短视频并停止打开返回的分享链接。按 Instant Mode 文档字幕、转写、摘要、章节等内容只在内容已生成、且 Cap 或组织设置允许时出现Quickstart 也提醒这些 AI 字段取决于录制、处理状态、计划和组织设置不要在上传后立刻假设每个 AI 字段都已就位。边界与下一步只配ASSEMBLY_API_KEY而不设AI_PROVIDERassemblyai时实例保持纯转写不会开始产生 LLM 费用这是文档设计的默认行为。仓库docker-compose.yml内置的占位密钥NEXTAUTH_SECRET、DATABASE_ENCRYPTION_KEY、MEDIA_SERVER_WEBHOOK_SECRET只适合本地测试公开部署前必须按自托管文档的 Production Checklist 生成并替换。全部可用环境变量的定义参考 packages/env/server.ts。如果你使用 Coolify 而非主 compose 文件注意其 compose 文件使用不同的变量名WEB_URL代替CAP_URL、S3_PUBLIC_ENDPOINT代替S3_PUBLIC_URL按自托管文档在 Coolify UI 中配置AI 变量同样需要在 Coolify 的项目环境中显式提供。【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
