---
title: "02-AI-API接口调用"
created: 2025-12-03
tags:
  - 小技能
---

# 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 模型类型**：

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

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

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

### 3. api-key（身份凭证）

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

**重要安全实践**：

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

## 三、API 调用流程

![[AI_API_调用-a72c0864.jpg]]

## 四、额度管理策略

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

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

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

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

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

### 多应用隔离方案

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

## 五、实际应用建议

1. **开发初期**：使用厂商提供的免费模型测试
2. **模型切换**：当一个模型额度用完，灵活切换到其他模型
3. **安全管理**：每个应用分配独立 key，避免跨应用污染
4. **成本优化**：合理规划模型选择，最大化利用免费额度
5. **监测告警**：设置 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]]