接入教程 - Kira的商城

三，Codex CLI 配置

环境变量方式

export OPENAI_API_KEY="你的key"
export OPENAI_BASE_URL="https://dogai.ai"
export OPENAI_MODEL="gpt-5.4"

测试命令：

codex exec --skip-git-repo-check "say hi"

一键脚本

#!/usr/bin/env bash
set -euo pipefail

API_KEY="${1:-}"
BASE_URL="${BASE_URL:-https://dogai.ai/v1}"
MODEL="${MODEL:-gpt-5.4}"
OUT_FILE="${HOME}/.codex-dogai.env"

if [[ -z "$API_KEY" ]]; then
  echo "用法: bash setup-codex-dogai.sh 'sk-xxxx'"
  exit 1
fi

cat > "$OUT_FILE" <提示：Codex CLI 某些版本使用的是 Responses API 路径，所以和普通 chat completions 客户端的行为可能略有不同。

四，Chatbox 配置

Provider：OpenAI
API Host：https://dogai.ai/v1
API Key：你的 key
Model：gpt-5.4 或 gpt-5.4-mini

如果模型测试失败，但实际聊天能返回，通常以实际聊天结果为准。

五，Cursor 配置

Provider / API Type：OpenAI Compatible
Base URL：https://dogai.ai/v1
API Key：你的 key
Model：gpt-5.4

如果当前版本不支持自定义 OpenAI endpoint，就不能直接这样接入。

六，其他 IDE / 客户端通用配置

通用填写方式

Base URL: https://dogai.ai/v1
API Key: 你的key
Model: gpt-5.4

常见可接入客户端

Cherry Studio
Open WebUI
NextChat
LobeChat
Python / Node 脚本

七，Python / Node 示例

Python

import requests

url = "https://dogai.ai/v1/chat/completions"
headers = {
    "Authorization": "Bearer 你的key",
    "Content-Type": "application/json"
}
data = {
    "model": "gpt-5.4",
    "messages": [
        {"role": "user", "content": "hi"}
    ]
}

resp = requests.post(url, headers=headers, json=data, timeout=30)
print(resp.status_code)
print(resp.text)

Node.js

const resp = await fetch("https://dogai.ai/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer 你的key",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "gpt-5.4",
    messages: [
      { role: "user", content: "hi" }
    ]
  })
});

console.log(resp.status);
console.log(await resp.text());

八，常见问题

1. 应该填 https://dogai.ai 还是 https://dogai.ai/v1？

大多数普通 OpenAI Compatible 客户端，应填写 https://dogai.ai/v1。但少数 CLI / SDK 会自行拼接路径，可能只需要主域名。

2. 测试报错但聊天能用？

这通常是客户端测试逻辑与正式聊天逻辑不一致，不一定是接口不可用。

3. 返回 403 或 Network Error？

检查是否漏了 /v1
检查 API Key 是否正确带上
检查客户端是否真支持 OpenAI Compatible
检查当前网络是否能访问 dogai.ai

九，安全提醒

不要把 API Key 发到公开群、工单或截图里
如果 key 泄露，请立刻更换
建议不同用途使用不同 key，方便排查和风控

DogAI 接入教程

一，先准备好 3 个参数

二，先用 curl 测一下是否正常