AsterMesh Wiki

在代码里通过 OpenAI SDK、Mastra、LangChain、LlamaIndex 使用 AsterMesh。

这个分区面向写代码接入的场景。如果你要配置的是现成客户端（Claude Code、Codex、Cursor、Chatbox 等），请直接看客户端示例，那里按客户端提供逐步配置示例。

无论用哪个 SDK 或框架，只需要关注三个字段：

字段	填写方式
API Key	AsterMesh 控制台创建的 Key
Base URL	OpenAI-compatible 通常填 `https://console.astermesh.cn/v1`
Model	控制台模型列表里的完整模型 ID

SDK

OpenAI SDK

Node.js、Python 和 curl 的通用接入方式。

环境变量

把 Key 和 Base URL 安全地放在本机或项目配置里。

Agent 框架

如果你在代码里构建 Agent，这些框架都能通过 OpenAI 兼容接口使用 AsterMesh：

Mastra

TypeScript Agent 框架，用 @ai-sdk/openai-compatible 接入。

LangChain

Python / TypeScript 通用，把 ChatOpenAI 指向 AsterMesh。

LlamaIndex

用 OpenAILike 对接，支持 RAG 和 Agent 场景。

先做连通性测试

写代码前，建议先用 curl 验证 Key 和模型可用：

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": "ping"
      }
    ]
  }'

如果 curl 成功，但代码失败，重点检查：

Base URL 是否填成 https://console.astermesh.cn/v1。
API Key 是否保存到了代码真正读取的位置（环境变量名是否一致）。
模型 ID 是否和控制台一致。

SDK 与框架接入

SDK