OpenAI SDK(Python / Node)
用 OpenAI 官方 SDK 通过 /v1/chat/completions 调用模型,只需要改 api_key 和 base_url。
AI 星图兼容 OpenAI 的 Chat Completions 接口(POST /v1/chat/completions),这是 OpenAI 兼容的通用接口。已有的 OpenAI 代码,只需要改两处:api_key 和 base_url。
安装
pip install openai基础调用
示例中的 your-model-id 请替换为模型广场中的模型 ID(也可以调用 GET /v1/models 查看)。
先把 API 密钥放进环境变量:
export MYAIEXP_API_KEY="sk-..."import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["MYAIEXP_API_KEY"],
base_url="https://ai.myaiexp.com/v1",
)
resp = client.chat.completions.create(
model="your-model-id", # 替换为模型广场中的模型 ID
messages=[{"role": "user", "content": "Introduce yourself in one sentence."}],
)
print(resp.choices[0].message.content)
print("usage:", resp.usage.prompt_tokens, "in /", resp.usage.completion_tokens, "out")要点:
base_url/baseURL必须带/v1:https://ai.myaiexp.com/v1。- 鉴权头是
Authorization: Bearer sk-...,SDK 会根据api_key自动加上。 model填模型 ID,区分大小写。在 模型广场 选择一个支持/v1/chat/completions的模型,使用它的模型 ID。- Key 从环境变量读取,不要写进代码或提交到仓库。
查看可用模型
curl -sS https://ai.myaiexp.com/v1/models \
-H "Authorization: Bearer $MYAIEXP_API_KEY"用 SDK 也一样:
for m in client.models.list():
print(m.id)GET /v1/models 返回的是当前 Key 能调用的全部模型。如果你在创建 Key 时设置了模型限制,这里只会列出允许的模型。
接口支持
每个模型支持的接口不同:/v1/chat/completions 是 OpenAI 兼容的通用接口;/v1/messages 适用于支持 Claude 原生格式的模型;/v1/responses 适用于支持 Responses 接口的模型。具体可用模型和每个模型支持的接口以 模型广场 为准。另见 Anthropic Messages 与 Responses 接口。
如果你的代码要在多个模型之间切换,用 Chat Completions 最省事:同一份代码,只换 model。
完整的模型列表和价格见 模型广场;价格每日同步各厂商官方公开刊例价,单位为美元 / 百万 tokens。你的 Key 能用哪些模型,以 GET /v1/models 返回为准。
思考类模型
思考类 / 推理类模型会先思考再回答。思考过程也计入输出 token,max_tokens 设得太小时可能思考没完就被截断,导致 content 为空。遇到这种情况请调大 max_tokens,或改用流式输出。
本服务仅供学习与研究用途。请遵守各模型提供方的使用政策。