快速开始

从注册账号、获取密钥到发送首条请求,完成 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 等框架编排 AgentMastra · LangChain · LlamaIndex

在正式配置业务代码或客户端工具前,建议先按照下文步骤使用 curl 发起一次测试请求,确认账号状态与网络连接正常。

1. 注册与登录

访问 AnyStarX 控制台,注册账号并完成登录。

登录控制台后,可以检查以下基础信息:

  • 账号激活状态与可用额度。
  • 控制台中的 API Key 管理、模型列表与用量明细入口。

2. 创建 API Key

进入控制台的密钥管理页面,创建新的 API Key。

创建密钥时建议结合具体的使用场景进行命名,例如:

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

密钥创建成功后会完整展示一次,请立即复制并保存至本地密码管理器或开发环境的配置文件中。控制台出于安全考虑不会再次完整显示已创建的密钥。

保护密钥安全

代码提交至公开仓库前,请将密钥写入环境变量或 .env.local 文件,并确保该文件已经列入 .gitignore 规则中,避免凭证泄露。

3. 配置 Base URL

兼容 OpenAI 协议的客户端和 SDK 统一使用以下基础地址:

https://console.anystarx.com/v1

基础地址只填写到 /v1 路径,不需要追加具体的接口后缀。例如,以下写法会导致路径拼接重复:

https://console.anystarx.com/v1/chat/completions

SDK 与客户端会自动根据调用的功能拼接 /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,只需调整初始化参数中的 apiKeybaseURL,其余调用逻辑保持不变。

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 URLhttps://console.anystarx.com/v1
Model控制台模型列表中复制的完整模型 ID
Provider / 服务商选择 OpenAI Compatible、OpenAI、自定义提供商或 Custom Endpoint

针对要求 Anthropic 协议的工具,可以参考 Claude Code 接入;命令行编码工具参考 Codex 接入。更多图形界面工具的配置说明参考 客户端示例

进阶文档

本页内容