AsterMesh Wiki

AsterMesh 通过一个统一的 OpenAI 兼容端点，让你访问 Claude、Gemini、OpenAI、DeepSeek 等主流模型。你不需要为每家模型厂商分别注册账号、管理密钥——只要一个 API Key 和一个 Base URL。

这页适合第一次使用 AsterMesh 的用户。你不需要先理解所有 API 概念，只要按顺序完成下面几步。

选择接入方式

接入方式	适合场景	文档
直接调用 API	任何语言、无额外依赖，或者想先用 curl 验证配置	本页下方示例
OpenAI SDK	项目已使用 OpenAI SDK，只改 `baseURL` 和 `apiKey` 即可迁移	OpenAI SDK 接入
Anthropic 兼容接口	Claude Code 等要求 Claude 原生协议的客户端	Anthropic Messages
客户端工具	Cursor、Codex、Chatbox 等图形界面工具，填表单即可	客户端示例
Agent 框架	用 Mastra、LangChain、LlamaIndex 等在代码里构建 Agent	Mastra · LangChain · LlamaIndex

不确定选哪个？先按下面的步骤用 curl 发一条请求，确认账号可用，再挑合适的接入方式。

1. 注册并登录

打开 AsterMesh 控制台，注册账号并登录。

登录后先确认三件事：

账号状态正常。
余额或套餐可用。
控制台里能看到 API Key、模型列表或用量记录入口。

2. 创建 API Key

在控制台找到 API Key、令牌或密钥管理页面，创建一个新的 Key。

建议命名成容易识别的用途，例如：

cursor-macbook
codex-local
claude-code-work
openai-sdk-test

复制后先保存在本机密码管理器或 .env.local。如果页面只显示一次，关闭后通常无法再次看到完整 Key。

不要把 Key 写进公开代码

如果你要上传代码到 GitHub，请把 Key 放进环境变量或 .env.local，并确认 .env.local 已经被 .gitignore 忽略。

3. 记住 Base URL

大多数兼容 OpenAI 的客户端填写这个地址：

https://console.astermesh.cn/v1

不要把完整接口路径填进 Base URL。下面是错误示例：

https://console.astermesh.cn/v1/chat/completions

Base URL 只填到 /v1。客户端会自己拼接 /chat/completions、/responses、/models 等路径。

4. 发送第一条请求

把下面的 YOUR_API_KEY 和 MODEL_ID 换成你自己的 API Key 和控制台里复制的模型 ID。

curl https://console.astermesh.cn/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "用一句话介绍 AsterMesh。"
      }
    ]
  }'

import requests

response = requests.post(
    "https://console.astermesh.cn/v1/chat/completions",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "MODEL_ID",
        "messages": [
            {"role": "user", "content": "用一句话介绍 AsterMesh。"}
        ],
    },
)

print(response.json()["choices"][0]["message"]["content"])

const response = await fetch('https://console.astermesh.cn/v1/chat/completions', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'MODEL_ID',
    messages: [
      { role: 'user', content: '用一句话介绍 AsterMesh。' },
    ],
  }),
});

const data = await response.json();
console.log(data.choices[0].message.content);

如果返回里能看到模型回复，说明账号、Key、Base URL 和模型都已经配置成功。

模型 ID 从哪里来

控制台的模型列表页可以直接复制模型 ID，也可以调用 GET https://console.astermesh.cn/v1/models 程序化获取当前账号可用的全部模型。详见模型与路由。

5. 使用 OpenAI SDK

如果你的项目已经在用 OpenAI SDK，只需要把 apiKey 和 baseURL 换成 AsterMesh 的即可，其余代码不用改。

from openai import OpenAI

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

completion = client.chat.completions.create(
    model="MODEL_ID",
    messages=[
        {"role": "user", "content": "用一句话介绍 AsterMesh。"}
    ],
)

print(completion.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://console.astermesh.cn/v1',
});

const completion = await client.chat.completions.create({
  model: 'MODEL_ID',
  messages: [
    { role: 'user', content: '用一句话介绍 AsterMesh。' },
  ],
});

console.log(completion.choices[0]?.message?.content);

更完整的示例（环境变量、Responses API、常见错误）见 OpenAI SDK 接入。

6. 接入你的工具

不同工具的配置入口不同，但核心字段基本一样：

字段	应该填什么
API Key	你在 AsterMesh 控制台创建的 Key
Base URL	`https://console.astermesh.cn/v1`
Model	控制台模型列表里的完整模型 ID
Provider	选择 OpenAI Compatible、OpenAI、自定义 Provider 或 Custom Endpoint

如果你使用的是 Claude Code，请阅读 Claude Code 接入。如果你使用的是 Codex，请阅读 Codex 接入。更多客户端的图文配置示例见客户端示例。