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-..."
chat.py
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 从环境变量读取,不要写进代码或提交到仓库。

查看可用模型

models.sh
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,或改用流式输出。

本服务仅供学习与研究用途。请遵守各模型提供方的使用政策。

本页目录