开始使用
新手快速开始
第一次使用 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
核对结果与使用日志
收到模型回复后,进入使用日志核对请求时间、模型和用量或扣费信息。确认调用效果和费用符合预期,再逐步增加请求量。
调用失败时先记录状态码和错误信息,按错误排查文档检查密钥、余额、模型标识及接口路径;仍无法解决时,将脱敏信息提交给客服。
完成检查
- 账号有可用余额,令牌已创建并可正常使用
- 实际模型标识和接口地址已确认,首次请求收到预期回复
- 已在使用日志核对调用记录和费用