AI 大模型 API 接入指南

开通准备

同时具备以下两项即可开始调用（着陆云可协助开通与购包）：

1. API Key：在模型控制台「密钥管理」创建，形如 xn-********。仅创建时完整展示，请妥善保存。
2. 积分资源包（推荐）或后付费余额：调用按「用量 × 消耗系数」扣积分；额度不足时按 Key 预算停止或转后付费。
3. 模型 ID：通过 GET https://airouter.xincache.cn/v1/models 或「模型广场」获取（创建 Key 时需勾选允许访问的模型）。

官方开发文档：快速开始 · 新网开放接口

积分资源包（四种规格）

有效期均为 1 年；积分可用于平台内文本 / 图片 / 音频 / 视频等模型，扣减公式：消耗积分 = 实际用量 × 消耗系数。以下为新网控制台标价参考，着陆云渠道售价请来询。

官网自助下单对接中；当前可 联系顾问 开通，或在新网控制台「资源包管理」购买。

调用参数（OpenAI 兼容）

开发调用示例

列出模型

curl https://airouter.xincache.cn/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

cURL 对话（可 stream）

curl https://airouter.xincache.cn/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-R1",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "用一句话介绍着陆云"}
    ],
    "stream": false
  }'

Python（openai SDK）

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://airouter.xincache.cn/v1/",
)

resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-R1",
    messages=[{"role": "user", "content": "一句话描述着陆云"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.XINNET_MODEL_API_KEY,
  baseURL: "https://airouter.xincache.cn/v1",
});

const resp = await client.chat.completions.create({
  model: "deepseek-ai/DeepSeek-R1",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

常用 IDE / 编辑器配置

凡支持「自定义 OpenAI Base URL」的工具均可接入。统一填写：

• Provider / API Type：OpenAI Compatible
• Base URL：上表中的地址（通常需带 /v1）
• API Key：你的 xn-… 密钥
• Model：模型广场中的模型 ID

{
  "models": [{
    "title": "Zhuolu Yun Model",
    "provider": "openai",
    "model": "deepseek-ai/DeepSeek-R1",
    "apiBase": "https://airouter.xincache.cn/v1",
    "apiKey": "YOUR_API_KEY"
  }]
}

安全与计费

• 优先使用积分资源包控制成本；可在 Key 上设置日/月预算。
• 生产环境建议配置 IP 白名单；前端浏览器切勿直连携带 Key。
• 调用消耗优先扣资源包；不足时按控制台规则转后付费或停用。
• 代理商侧用量/账单可通过新网模型服务开放 API 查询（统计、扣费记录），与终端推理 Key 不是同一套鉴权。

常见问题