跳到主要内容

OpenAI CLI 集成图灵平台指南

OpenAI CLI 是 OpenAI 官方提供的命令行工具，可以从终端直接调用 Responses / Chat / Embeddings / Images / Audio 等接口。其本质是一个轻量 HTTP 客户端，通过 OPENAI_BASE_URL 环境变量指向任意 OpenAI 兼容端点——图灵平台的 /api/v1 即原生兼容，配置两个环境变量即可使用。

同样适用于其他 OpenAI 兼容客户端

图灵的 OpenAI 兼容接口对所有遵循 OPENAI_BASE_URL 约定的客户端通用：openai-python / openai-node SDK、LiteLLM、LangChain、LlamaIndex、aider、Continue.dev 等。配置思路与本文一致——把 base URL 指向 https://live-turing.cn.llm.tcljd.com/api/v1，把 API Key 填入 OPENAI_API_KEY。

前置要求​

  • 已获得图灵平台 API Key（获取方式）
  • macOS / Linux / WSL2（Go 版需要 Go 1.25+，或直接用 Homebrew）

步骤 1：安装​

OpenAI 提供两个 CLI，选其一即可：

官方 Go 版（推荐，与文档语法一致）​

# Homebrew
brew install openai/tools/openai

# 或 go install
go install github.com/openai/openai-cli/cmd/openai@latest

openai --version

Python SDK 自带的 CLI（旧版，pip 装 openai 时附带）​

pip install openai
openai --version   # 例如 1.102.0
两个 CLI 子命令语法不同
  • Go 版：openai responses create --model X --input "..."（与官方文档一致）
  • Python 版：openai api chat.completions.create -m X -g user "..."，且 不支持 embeddings / responses 子命令——这两个端点请改用 Python SDK 一行调用。

步骤 2：配置环境变量​

export OPENAI_API_KEY="<你的图灵 API Key>"
export OPENAI_BASE_URL="https://live-turing.cn.llm.tcljd.com/api/v1"

写入 ~/.zshrc 或 ~/.bashrc 持久化。

步骤 3：验证​

Go 版​

# 列模型
openai models list

# Responses API
openai responses create \
  --model turing/gpt-5.5 \
  --input "用一句话介绍图灵平台"

# Chat Completions
openai chat completions create \
  --model turing/gpt-5.5 \
  --message role=user,content="hello"

Python 版​

# 列模型
openai api models.list

# Chat Completions
openai api chat.completions.create \
  -m turing/gpt-5.5 \
  -g user "hello"

# Embeddings / Responses 走 Python SDK
python -c "import openai; print(openai.OpenAI().responses.create(\
  model='turing/gpt-5.5', input='hello').output_text)"

python -c "import openai; print(len(openai.OpenAI().embeddings.create(\
  model='turing/text-embedding-3-small', input='hello').data[0].embedding))"

常用接口对照​

用途Go 版命令Python 版命令 / 替代
列模型openai models listopenai api models.list
Chat Completionsopenai chat completions createopenai api chat.completions.create
Responses APIopenai responses createPython SDK：client.responses.create(...)
Embeddingsopenai embeddings createPython SDK：client.embeddings.create(...)
图像生成openai images generateopenai api images.generate
语音合成 / 转写openai audio:speech create / audio:transcriptions createopenai api audio.transcriptions.create

完整子命令与参数请参考 OpenAI CLI 官方文档。

故障排除​

401 / 403​

  • 确认 OPENAI_API_KEY 已设置：echo $OPENAI_API_KEY
  • API Key 必须是 sk- 开头的图灵平台 Key

404 Not Found​

  • 确认 OPENAI_BASE_URL 末尾包含 /api/v1，不要漏 /v1
  • 正确：https://live-turing.cn.llm.tcljd.com/api/v1

模型名称错误​

  • 图灵模型名通常带 turing/ 前缀（如 turing/gpt-5.5、turing/text-embedding-3-small）
  • 完整列表：模型列表 或 openai models list

参考文档​