SDK 与框架接入
通过官方 OpenAI SDK、Mastra、LangChain 与 LlamaIndex 等框架将 AnyStarX 集成进代码工程。
本指南面向通过编写代码集成大模型能力的开发场景。如果需要配置现成的编辑器插件或桌面应用（如 Claude Code、Codex、Cursor、Cherry Studio 等），可以查阅 客户端示例。
无论使用哪一种开发语言或框架，对接的核心配置项均保持统一：
| 配置项 | 填写规范 |
|---|---|
| API Key | 在管理控制台创建的有效密钥 |
| Base URL | 兼容 OpenAI 协议的端点统一配置为 https://console.anystarx.com/v1 |
| Model ID | 管理控制台模型列表中标注的完整模型标识符 |
通用 SDK 接入
应用与 Agent 框架
在自研项目中编排自主智能体、检索增强生成（RAG）或工作流时，可通过以下框架接入：
Mastra
面向 TypeScript 的 Agent 框架，基于 @ai-sdk/openai-compatible 模块接入。
LangChain
支持 Python 与 TypeScript，将 ChatOpenAI 组件直接对接到目标端点。
LlamaIndex
使用 OpenAILike 组件集成，适配 RAG 索引构建与智能体查询。
网络连通性验证
在编写应用代码前，建议先使用命令行执行最小调用，验证密钥权限与网络连通性：
curl https://console.anystarx.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [
{
"role": "user",
"content": "ping"
}
]
}'如果命令行请求可以正常返回内容，但应用程序内调用报错，应重点排查以下三项：
- 代码中初始化的 Base URL 是否严格配置为
https://console.anystarx.com/v1，没有多写具体的接口后缀。 - 环境变量是否已正确加载进当前进程（核对代码中读取的变量名与实际设置的名称是否一致）。
- 请求中传入的
model字段是否与控制台中的完整 ID 保持一致。