快速开始
从注册账号、获取密钥到发送首条请求,完成 AnyStarX 的基础配置与连通性验证。
AnyStarX 提供统一的接口端点,支持通过标准协议调用 Claude、Gemini、OpenAI、DeepSeek 等模型。接入时只需要使用一个管理账号创建 API Key,并将请求的基础地址指向 AnyStarX 即可。
本文按照注册登录、创建密钥、配置地址和调用测试的顺序介绍基础接入流程。
接入方式概览
| 接入方式 | 适用场景 | 参考文档 |
|---|---|---|
| 直接调用 API | 任何编程语言、无外部依赖环境,或使用命令行验证网络连通 | 本文测试请求示例 |
| OpenAI SDK | 已使用官方 OpenAI SDK 的项目,只需修改基础地址与密钥 | OpenAI SDK 接入 |
| Anthropic 协议接口 | Claude Code 等使用 Anthropic 原生协议的客户端 | Anthropic Messages |
| 桌面与编辑器客户端 | Cursor、Codex、Cherry Studio 等通过界面配置参数的工具 | 客户端示例 |
| Agent 开发框架 | 在代码中使用 Mastra、LangChain、LlamaIndex 等框架编排 Agent | Mastra · LangChain · LlamaIndex |
在正式配置业务代码或客户端工具前,建议先按照下文步骤使用 curl 发起一次测试请求,确认账号状态与网络连接正常。
1. 注册与登录
访问 AnyStarX 控制台,注册账号并完成登录。
登录控制台后,可以检查以下基础信息:
- 账号激活状态与可用额度。
- 控制台中的 API Key 管理、模型列表与用量明细入口。
2. 创建 API Key
进入控制台的密钥管理页面,创建新的 API Key。
创建密钥时建议结合具体的使用场景进行命名,例如:
cursor-macbook-procodex-localclaude-code-workopenai-sdk-test
密钥创建成功后会完整展示一次,请立即复制并保存至本地密码管理器或开发环境的配置文件中。控制台出于安全考虑不会再次完整显示已创建的密钥。
保护密钥安全
代码提交至公开仓库前,请将密钥写入环境变量或 .env.local 文件,并确保该文件已经列入 .gitignore 规则中,避免凭证泄露。
3. 配置 Base URL
兼容 OpenAI 协议的客户端和 SDK 统一使用以下基础地址:
https://console.anystarx.com/v1基础地址只填写到 /v1 路径,不需要追加具体的接口后缀。例如,以下写法会导致路径拼接重复:
https://console.anystarx.com/v1/chat/completionsSDK 与客户端会自动根据调用的功能拼接 /chat/completions、/responses 或 /models 等完整路径。
4. 发送测试请求
将以下命令中的 YOUR_API_KEY 替换为实际创建的密钥,将 MODEL_ID 替换为控制台中复制的模型名称:
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": "用一句话介绍 AnyStarX。"
}
]
}'import requests
response = requests.post(
"https://console.anystarx.com/v1/chat/completions",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
json={
"model": "MODEL_ID",
"messages": [
{"role": "user", "content": "用一句话介绍 AnyStarX。"}
],
},
)
print(response.json()["choices"][0]["message"]["content"])const response = await fetch('https://console.anystarx.com/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: '用一句话介绍 AnyStarX。' },
],
}),
});
const data = await response.json();
console.log(data.choices[0].message.content);如果返回的数据结构中包含模型回复文本,说明账号权限、密钥有效性以及基础网络连接均已通过验证。
获取模型 ID
控制台模型列表页提供可用模型的完整 ID 复制入口;也可以通过调用 GET https://console.anystarx.com/v1/models 接口获取当前账号有权限使用的模型列表。详细规范参考 模型与路由。
5. 使用 OpenAI SDK 调用
项目如果已经引入官方 OpenAI SDK,只需调整初始化参数中的 apiKey 与 baseURL,其余调用逻辑保持不变。
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://console.anystarx.com/v1",
)
completion = client.chat.completions.create(
model="MODEL_ID",
messages=[
{"role": "user", "content": "用一句话介绍 AnyStarX。"}
],
)
print(completion.choices[0].message.content)import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'YOUR_API_KEY',
baseURL: 'https://console.anystarx.com/v1',
});
const completion = await client.chat.completions.create({
model: 'MODEL_ID',
messages: [
{ role: 'user', content: '用一句话介绍 AnyStarX。' },
],
});
console.log(completion.choices[0]?.message?.content);关于环境变量配置、Responses 接口调用与常见错误排查,可以查阅 OpenAI SDK 接入。
6. 客户端工具接入
常见 AI 工具的配置界面名称可能有所不同,但基本配置项保持一致:
| 参数项 | 填写内容 |
|---|---|
| API Key | 在控制台创建的有效密钥 |
| Base URL | https://console.anystarx.com/v1 |
| Model | 控制台模型列表中复制的完整模型 ID |
| Provider / 服务商 | 选择 OpenAI Compatible、OpenAI、自定义提供商或 Custom Endpoint |
针对要求 Anthropic 协议的工具,可以参考 Claude Code 接入;命令行编码工具参考 Codex 接入。更多图形界面工具的配置说明参考 客户端示例。