跳到主要内容
Orqra
浏览文档

开始使用

快速开始

覆盖安装 Orqra、连接模型服务商、理解 BYOK 责任边界的核心设置指南。

你将完成

安装经过验证的构建后启动 Orqra；Free 无需账号或 License。

本指南内容

  1. 1
    打开 Orqra — 安装经过验证的构建后启动 Orqra；Free 无需账号或 License。
  2. 2
    选择版本 — 继续使用 Free，或通过购买 Email 与 License Key 激活 Personal。
  3. 3
    接入 Provider — 打开模型页，添加自己的 Provider 凭证，选择模型，保存并测试连接。
AI 短剧工作流
快速开始安装经过验证的构建后启动 Orqra；Free 无需账号或 License。

开始之前

  • 安装经过验证的构建后启动 Orqra；Free 无需账号或 License。
  • API Key 保存在本地。不要把它发送给 Orqra 支持，也不要在 Orqra 官网填写。
  • 模型可用性、能力、速率限制和费用由 Provider 决定；Orqra 不包含 AI 模型额度。

完成操作

  1. 1

    Download / Open Orqra

    系统要求

    安装经过验证的构建后启动 Orqra；Free 无需账号或 License。

    预期结果

    经过验证的 Orqra 构建已在受支持设备上打开。

  2. 2

    Free / Account & License

    选择版本

    继续使用 Free，或通过购买 Email 与 License Key 激活 Personal。

    预期结果

    你正在使用 Free；只有主动选择激活时才会进入 Personal 激活。

  3. 3

    Models / Service Connections

    接入 Provider

    打开模型页，添加自己的 Provider 凭证，选择模型，保存并测试连接。

    预期结果

    Provider 服务连接编辑器已准备好填写你自己的账号配置。

  4. 4

    Save / Test Connection / Sync Models

    测试并同步

    输入 API Key 或 Provider 专用凭证后保存。测试连接或同步模型前，必须先保存敏感配置；已保存的 API Key 不会再次显示。 先使用“测试连接”，再用“同步模型”刷新可用模型列表。这些操作会连接 Provider，但不会发起生成请求。 把需要的模型加入“我的模型”并启用。Free 最多启用 3 个模型；Personal 不设版本级启用模型数量上限。

    预期结果

    连接已保存、模型列表已刷新，工作流需要的模型已经启用。

  5. 5

    Projects / Add node

    创建项目

    新建项目，添加输入与处理节点，连接流程并选择所需模型。

    预期结果

    本地项目中已有一条从输入、处理到输出的完整连接工作流。

  6. 6

    Request Preview

    运行前先核对

    请求预览分别显示系统提示词、任务指令、解析输入、最终 User 输入、模型和关键参数。

    预期结果

    Request Preview（请求预览）显示准备发送的模型、任务指令、解析输入和关键参数。

  7. 7

    Run / Output node

    核对并运行

    插入可复用模板，检查请求预览；确认输入、模型和参数无误后再运行。

    预期结果

    只有明确点击运行后才开始调用，Provider 返回的输出继续附着在项目中。

  8. 8

    Local data / Support

    先了解哪些内容留在本地，哪些会离开设备

    工作区采用 local-first 与 BYOK；模型请求只通过你配置的 Provider 连接发送。

    预期结果

    你已经知道哪些数据留在本地、哪个 Provider 会接收请求，以及失败时从哪里检查。

重试前检查

  • 请使用 Provider 或自定义网关官方文档规定的端点与凭证格式。
  • 支持可以说明 Orqra 设置字段，但服务商 API Key、计费、速率限制和模型可用性仍由你的服务商负责。
  • 仅创建或编辑项目、节点和模板不会调用模型 Provider。