快速开始

带上密钥，选择服务商与模型，粘贴 API 密钥，在 Cordy for Mobile 上几秒内开始对话。

Cordy for Mobile 采用自带密钥方式：你无需注册 Cordy 账号，而是连接自己在 AI 服务商处的 API 密钥。首次启动的目标很简单——带上密钥，掌握控制权，几秒内即可开始对话。

平台说明。 以下步骤面向已完整验证的 Android 平台编写。iOS 由同一套代码编译，但尚未在真机上验证，相机 / 图片 / 语音采集也尚未接入。见常见问题。

开始之前

你只需要一样东西：来自受支持服务商的 API 密钥。Cordy 不出售额度、也不转售模型访问——你使用自己在服务商处的账户，并直接按用量向服务商付费。

如果还没有密钥，下方的在哪里获取密钥会逐一介绍各服务商。若只想走最快路径，创建一把 OpenRouter 密钥：一把密钥即可触达 100+ 模型。

首次启动：引导

首次打开应用时，一段简短引导会用三张卡片说明这一模式：

  • 默认本地——除非你主动清除，会话会保留在这台设备上。
  • 自带密钥——密钥通过设备安全存储保存（Android 密钥库 / iOS 钥匙串）。
  • 服务商请求——提示词只会发送给你选择的服务商。

点击打开设置即可配置你的第一个服务商。之后可从设置 → 显示引导重新打开这段引导。

三步发出第一条消息

1. 打开设置，选择服务商与模型

打开设置（对话界面上的齿轮）。在服务商下选择消息发往何处，默认已选中 OpenRouter。在模型下选择一个模型——保存密钥后，列表会填入该服务商的实时目录与每个模型的定价（显示为“In $… / Out $… per 1M”）。

2. 粘贴你的 API 密钥

在 API 密钥区域粘贴密钥并点击保存密钥。Cordy 会确认“API 密钥已保存。保存在本设备上。”并立即加载该服务商的模型目录。密钥仅写入设备安全存储——绝不写入对话数据库或日志。

3. 开始对话

回到对话界面。输入框显示 “Message CordyAI”，空状态提示为 “Ask privately.”（私密提问）。发送第一条消息，回复会实时流式返回，并在到达时以 Markdown 渲染。

就是这样——无需邮箱、无需验证、无需账号。

在哪里获取密钥（按服务商）

密钥始终在服务商自己的控制台创建，然后粘贴到 Cordy。多数服务商要求先充值或开通计费，密钥才能发起请求。

OpenRouter（默认，推荐作为第一把密钥）

  1. 前往 openrouter.ai/keys 并登录。
  2. 创建一把新的 API 密钥并复制。
  3. 为 OpenRouter 账户充值（Settings → Credits），以便请求成功。
  4. 在 Cordy 中：设置 → 服务商 → OpenRouter → 粘贴密钥 → 保存密钥。

一把 OpenRouter 密钥即可触达多家厂商的模型（Anthropic、OpenAI、Google、Meta 等），其目录含实时定价，Cordy 因此能显示每个模型的花费。

OpenAI

  1. 前往 platform.openai.com/api-keys。
  2. 创建一把新的密钥并复制（之后将无法再次查看）。
  3. 确认你的 OpenAI 账户已开通计费。
  4. 在 Cordy 中：设置 → 服务商 → OpenAI → 粘贴密钥 → 保存密钥。

Anthropic

  1. 前往 console.anthropic.com 并打开 API keys。
  2. 创建一把密钥并复制。
  3. 确认你的 Anthropic 账户有额度/计费。
  4. 在 Cordy 中：设置 → 服务商 → Anthropic → 粘贴密钥 → 保存密钥。

Anthropic 运行于 Cordy 的 原生 Anthropic 集成之上，支持扩展思考（见生成控制）。

Vercel AI Gateway

  1. 打开你的 Vercel 控制台 并进入 AI Gateway。
  2. 为网关创建一把 API 密钥并复制。
  3. 在 Cordy 中：设置 → 服务商 → Vercel AI Gateway → 粘贴密钥 → 保存密钥。

火山方舟 Ark

  1. 打开方舟控制台。
  2. 创建一把 API 密钥并复制。
  3. 在 Cordy 中：设置 → 服务商 → Volcengine Ark → 粘贴密钥 → 保存密钥。

你自己的端点

在运行自托管或内部的兼容 OpenAI 服务？你可以将其添加为自定义服务商，而不必使用内置项。

确认是否成功

  • 点击保存密钥后，模型列表应填入真实模型与价格。若仍停留在初始（bootstrap）条目，说明密钥可能缺失或被拒绝。
  • 发送一条简短消息。流式回复即表示端到端成功。
  • 打开设置 → Token 用量，查看这条消息记录的 token 与估算费用。

如果出了问题

  • “请检查你的 API 密钥”——密钥缺失、为空或被拒绝（HTTP 401/403）。请在设置中重新粘贴。
  • “服务商额度已用尽”——请到服务商处充值/开通计费（HTTP 402）。
  • “服务商触发限流”——稍候片刻后重试（HTTP 429）。

完整恢复指南见常见问题与排查。