# 极智 API 开发者接入与工具链集成指南 (Developer Integration Guide)

> **文档定位**：本指南为开发者、独立开发团队与企业 AI 应用提供基于极智 API (`api.lmxxz.xyz`) 的一站式接入与开发工具配置指引。覆盖 Claude Code、Codex CLI、OpenCode、主流 SDK（OpenAI / Anthropic / Gemini 原生协议）配置与实战调用示例。  
> **服务特性**：OpenAI / Anthropic / Gemini 原生协议兼容 | P50 188ms 亚太优化专线 | 原生透传 Prompt Caching（1 折起） | USDT(TRC20) 自助充值与微信人工收款。

---

## 一、 快速接入参数速查

| 配置项 | 推荐兼容配置参数 |
| :--- | :--- |
| **OpenAI 兼容 Base URL** | `https://api.lmxxz.xyz/v1` |
| **Anthropic 兼容 Base URL** | `https://api.lmxxz.xyz` （或追加 `/v1`） |
| **Gemini 兼容 Base URL** | `https://api.lmxxz.xyz/v1beta` |
| **备用线路 (Cloudflare CDN)** | `https://api.lmxww.xyz` |
| **API Key 格式** | `sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
| **推荐旗舰编程与推理模型** | `claude-sonnet-5`, `claude-opus-4-6`, `gpt-6-astra`, `gpt-5.6-sol` |
| **长上下文与高性价比模型** | `gemini-3.8-flash-high`, `gemini-4-argon`, `gpt-5.6-terra` |
| **国产大模型混合推荐** | `deepseek-flash`, `deepseek-v4.1-flash-1017`, `kimi-k2.7-code`, `qwen3.8-27b` |

---

## 二、 命令行开发工具接入

### 1. Claude Code CLI 终端工具配置
在终端中设置环境变量后即可直接启动 Claude Code：

**Linux / macOS (Bash / Zsh)**:
```bash
export ANTHROPIC_BASE_URL="https://api.lmxxz.xyz"
export ANTHROPIC_API_KEY="sk-YOUR_API_KEY"
claude
```

**Windows (PowerShell)**:
```powershell
$env:ANTHROPIC_BASE_URL = "https://api.lmxxz.xyz"
$env:ANTHROPIC_API_KEY = "sk-YOUR_API_KEY"
claude
```

### 2. Codex CLI 配置
Codex CLI 采用标准 OpenAI 兼容协议，通过设置环境变量即可接入：

```bash
export OPENAI_BASE_URL="https://api.lmxxz.xyz/v1"
export OPENAI_API_KEY="sk-YOUR_API_KEY"
```

推荐配合模型 `gpt-6-astra`、`gpt-5.6-sol` 或 `codex-auto-review` 执行代码分析与重构。

### 3. OpenCode 接入配置
OpenCode 支持标准 OpenAI 兼容协议配置：
* **Provider**：选择 `OpenAI Compatible`
* **Base URL**：`https://api.lmxxz.xyz/v1`
* **API Key**：填入极智令牌（`sk-...`）
* **Model**：推荐填入 `claude-sonnet-5` 或 `gpt-6-astra`

### 4. 客户端与扩展接入速查
* **Cursor IDE**：在 Settings -> Models 中开启 OpenAI API Key，设置 Override OpenAI Base URL 为 `https://api.lmxxz.xyz/v1`，添加模型 `claude-sonnet-5`、`gpt-6-astra`。
* **VS Code Cline / Roo Code**：API Provider 选择 `OpenAI Compatible`（Base URL: `https://api.lmxxz.xyz/v1`）或 `Anthropic`（Base URL: `https://api.lmxxz.xyz`）。
* **CC Switch**：支持一键导入配置（URL Scheme: `ccswitch`）。
* **Cherry Studio**：支持通过 URL Scheme 或手动配置添加 OpenAI 兼容服务商。

---

## 三、 主流 SDK 调用实战（Python & curl）

### 1. OpenAI 官方 SDK / curl 接入

#### curl 请求示例：
```bash
curl https://api.lmxxz.xyz/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "messages": [
      {"role": "user", "content": "Write a Python script for binary search."}
    ],
    "temperature": 0.2
  }'
```

#### Python SDK 示例：
```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.lmxxz.xyz/v1",
    api_key="YOUR_API_KEY"
)

response = client.chat.completions.create(
    model="gpt-6-astra",
    messages=[
        {"role": "system", "content": "You are an expert software engineer."},
        {"role": "user", "content": "Write a Python script for binary search."}
    ],
    temperature=0.2
)

print(response.choices[0].message.content)
```

---

### 2. Anthropic Claude SDK / curl 接入

极智 API 原生兼容 Anthropic `/v1/messages` 接口规范，完整保留 Extended Thinking `<thinking>` 深度推理块。

#### curl 请求示例：
```bash
curl https://api.lmxxz.xyz/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Explain the architecture of Transformer in one paragraph."}
    ]
  }'
```

#### Python SDK 示例：
```python
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.lmxxz.xyz",
    api_key="YOUR_API_KEY"
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Explain the architecture of Transformer in one paragraph."}
    ]
)

print(message.content[0].text)
```

---

### 3. Google Gemini 接口接入

极智 API 原生打通 Google 官方原生 `/v1beta/` 接口，同时支持通用 OpenAI 兼容调用，执行统一 1 倍率。

#### curl 请求示例（OpenAI 兼容 /v1）：
```bash
curl https://api.lmxxz.xyz/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.8-flash-high",
    "messages": [
      {"role": "user", "content": "Hello! List 3 advantages of microservices architecture."}
    ]
  }'
```

#### curl 请求示例（Gemini /v1beta 原生协议）：
```bash
curl "https://api.lmxxz.xyz/v1beta/models/gemini-3.8-flash-high:generateContent?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"parts": [{"text": "Hello! List 3 advantages of microservices architecture."}]}
    ]
  }'
```

亦支持在 HTTP 请求头中传入 `x-goog-api-key: YOUR_API_KEY` 或标准 `Authorization: Bearer YOUR_API_KEY`。

#### Python 调用示例（通用 OpenAI 兼容写法）：
```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.lmxxz.xyz/v1",
    api_key="YOUR_API_KEY"
)

response = client.chat.completions.create(
    model="gemini-3.8-flash-high",
    messages=[
        {"role": "user", "content": "Hello! List 3 advantages of microservices architecture."}
    ]
)

print(response.choices[0].message.content)
```

---

## 四、 Prompt Caching 与长上下文支出优化

在长代码重构、代码库分析、知识库检索与多轮 Agent 场景中，重复传入相同的前置上下文将产生大量冗余 Token 开销。

1. **缓存机制**：极智 API 原生透传上游 Prompt Caching 协议，模型命中缓存后自动执行阶梯折扣。
2. **折扣费率**：
   * OpenAI / Claude / Gemini 适用模型：缓存读取费率仅为输入标准的 **10%**（`CacheRatio 0.10`，立省 90%）。
   * Grok 4.6 为 25%（`CacheRatio 0.25`），Grok 4.5 为 15%（`CacheRatio 0.15`）。
3. **超长长连接保活**：平台亚太专线支持 600 秒超长 TCP Keep-Alive 保活，确保复杂长推理与大规模代码生成平稳完成不超时。

---

## 五、 充值结算与账户说明

* **充值方式**：支持 USDT（TRC20）自助充值与微信人工收款（扫码后联系客服人工入账）。
* **充值门槛**：最低充值金额为 $5（¥34）。
* **计费币种**：显示币种为美元（USD），按中间价 1 USD = 6.7180 CNY（¥1 ≈ $0.1489）折算。
* **额度有效期**：账户额度长期有效，不设自然月强制过期时间。
* **服务性质**：平台面向个人开发者、开发团队及企业提供按量计费的技术服务。