开始使用

新手快速开始

第一次使用 AINN API?按下面的顺序准备账号、可用余额、API Key 和模型标识,再完成一次小规模调用。有账号或已完成某一步时,可以通过本文目录直接跳到下一步。

1

章节 1

注册并登录账号

API 账号在 api.ainn.cc 控制台注册和管理。完成注册后登录,后续充值、创建令牌和查看日志都使用同一个账号。

2

章节 2

准备可用余额

调用前先在控制台确认账户有可用余额。可以选择申请体验额度,或通过钱包充值后开始测试。

  • 希望先体验:注册后生成申请说明,联系客服提交;是否发放及额度数量以客服审核结果为准
  • 准备直接使用:前往钱包充值,当前最低充值 $1;实际支付方式和金额以结算页面为准
提交体验申请后,请等待客服确认并核对余额到账,再发起调用。
3

章节 3

创建 API 令牌

进入“API 令牌”页面,点击“添加令牌”,填写便于识别的名称并按用途设置路由模式、过期时间和使用限制。保存后复制密钥,供服务端或可信客户端使用。

  • 希望平台综合选择渠道时,可以选择“智能自动”
  • 需要控制成本、响应速度或稳定性时,查看智能路由文档后选择对应模式
  • 为不同项目创建不同令牌,密钥不要放进网页源码或公开仓库
4

章节 4

选择模型并确认接口地址

从模型广场复制当前可用模型的准确标识,并查看价格和支持能力。首次验证建议选择适合文本对话的模型,发送简短内容。

OpenAI 兼容 SDK 的 Base URL 为 https://api.ainn.cc/v1。直接发送对话 HTTP 请求时,完整地址为 https://api.ainn.cc/v1/chat/completions。

示例中的 your-model 是占位符,需要替换成实际模型标识。部分客户端会自动添加 /v1,配置时避免重复。
5

章节 5

完成第一次调用

按你的接入方式选择下方示例,将密钥和模型标识替换为自己的配置,发送一次简短请求。首次验证时先使用少量请求,确认接口连通和回复符合预期。

6

章节 6

核对结果与使用日志

收到模型回复后,进入使用日志核对请求时间、模型和用量或扣费信息。确认调用效果和费用符合预期,再逐步增加请求量。

调用失败时先记录状态码和错误信息,按错误排查文档检查密钥、余额、模型标识及接口路径;仍无法解决时,将脱敏信息提交给客服。

完成检查

  • 账号有可用余额,令牌已创建并可正常使用
  • 实际模型标识和接口地址已确认,首次请求收到预期回复
  • 已在使用日志核对调用记录和费用