AI-API接口调用

📚 AI 工具箱第二篇：API 调用的三要素与额度管理思路。具体配置实操（Cherry Studio / Claude Code / CodeX）见 01-AI使用。

一、传统方式 vs 接口方式

传统方式的痛点：

进入 AI 网页进行对话，一问一答模式，操作繁琐
难以绕过网络限制
可能涉及费用缴纳问题
无法进行批量化、程序化调用

接口方式的优势：

通过 API 直接调用，支持程序集成和自动化
灵活的计费和额度管理
便于应用部署和扩展

二、API 调用的三个核心参数

要素	作用	类比	示例
base_url	区分不同厂商	邮政局地址	`api.aliyun.com`
model	选择具体的模型	选择快递方式	`qwen-turbo`
api-key	用户身份 & 计费凭证	身份证 + 账户	`sk-xxx...`

1. base_url（厂商区分）

作用：指向不同 AI 服务商的服务器地址。

厂商	示例
阿里云	`https://api.aliyun.com/...`
字节跳动	`https://api.bytedance.com/...`
其他厂商	`https://api.xxx.com/...`

核心要点：不同厂商有不同的 URL 前缀，用于路由请求到正确的服务器。

2. model（模型选择）

作用：在特定厂商下选择具体的模型。

AI 模型类型：

🗣️ 语言模型——文本生成、对话、理解
👁️ 视觉模型——图像识别、分析、生成
💻 代码模型——代码生成、修复、优化

灵活额度策略：每个模型每月都有免费调用次数；某个模型用完？只需切换到其他模型。本质就是修改一个字符串参数：

model="qwen-turbo"        # 通用语言模型
model="qwen-vl"           # 视觉语言模型
model="qwen-coder"        # 代码模型
# 切换只需改这个参数！

3. api-key（身份凭证）

作用：关联用户身份、作为计费凭证、跟踪 API 调用额度。

重要安全实践：

✅ 一个应用使用一个独立的 key
✅ 做好隔离和访问控制
✅ 定期轮换 key
❌ 不要硬编码在代码中
❌ 不要在版本控制中提交 key

三、API 调用流程

四、额度管理策略

单个模型额度用完后的处理

场景：阿里的 qwen-turbo 本月免费额度已用完

解决方案：
1. 查看其他可用模型
   qwen-plus  ← 还有免费次数
   qwen-long  ← 还有免费次数

2. 切换模型参数
   model="qwen-turbo"  ❌ (已用完)
         ↓
   model="qwen-plus"   ✅ (切换)

3. 仅需修改一个参数，无需改动其他逻辑

多应用隔离方案

┌─────────────────────────────────────────┐
│         同一厂商，多个应用               │
├─────────────────────────────────────────┤
│  应用 A  →  api-key-A                   │
│  应用 B  →  api-key-B                   │
│  应用 C  →  api-key-C                   │
│                                         │
│  优势：                                 │
│  ✅ 独立计费统计                        │
│  ✅ 权限隔离                            │
│  ✅ 便于成本分配                        │
└─────────────────────────────────────────┘

五、实际应用建议

开发初期：使用厂商提供的免费模型测试
模型切换：当一个模型额度用完，灵活切换到其他模型
安全管理：每个应用分配独立 key，避免跨应用污染
成本优化：合理规划模型选择，最大化利用免费额度
监测告警：设置 API 调用监控，及时发现异常

六、体验记录

🔒 以下为个人 key 记录，仅私有库自用。

grok api

基础 URL：https://jimiai.ai/v1
供应商：openai
Grok key：sk-eXUINQFwvftZzMlTgNVv2UxK9XbJ3ld3yeYKjsv09t5C9wXw

claude api

基础 URL：https://ai-router.plugins-world.cn/v1
供应商：anthropic
key：sk-sefAvqnF857ZPFhw5GB0ez7hFQjTJWV6pJx12gezvsgdLcIi
基础 URL：https://jimiai.ai
供应商：anthropic
key：sk-YPCDzicSTN9DsHT8qYO6XsSTQgwT4eqOQuKAfsRqYgZt8QcD
备用：sk-1rgS8HhsNtd2hVPPBmre3VtAMWlnIEUdUj8Ny8J5q4HEh2TA

ClaudeCode

sk-ant-api03-kCnGJviX1Eo3wKH5Oru2DJ8k8tNQjjjhERNYa1dzloXebRySCj-1KBk0Li-Z29mjhMUabShzjLhv-rIVr8bRBA

⬅️ 01-AI使用 🏠 00-小技能 ➡️ 01-PixPin

02-AI-API接口调用