10分钟跑通 147ai：OpenAI 兼容 chat/completions 最小模板（curl + Python）

先给你可复制的结果：只要你有 Key，下面两段（curl/Python）就能直接跑通：

• POST https://147ai.com/v1/chat/completions
• Authorization: Bearer <KEY>

接口参考：147API Apifox 接口文档

---

TL;DR（你只需要改 3 个地方）

1. 把 YOUR_147AI_API_KEY 换成你的 Key
2. 把 model 换成你们控制台支持的模型完整名称
3. base_url 固定填：https://147ai.com/v1

---

0）10 分钟跑通路径

注册 → 充值（或联系客服）→ 创建 Key → 打开接口文档确认 Base URL/模型名 → 跑下面任意一段代码。

入口：147ai 官网

---

1）curl（最小、最好排错）

curl -X POST 'https://147ai.com/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_147AI_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-4.1-mini",
    "messages": [
      { "role": "user", "content": "Hello! 用中文一句话介绍你自己。" }
    ]
  }'

能通就说明：Key/接口地址/模型名基本没问题。

---

2）Python（OpenAI SDK 兼容写法）

安装：

pip install -U openai

代码：

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_147AI_API_KEY",
    base_url="https://147ai.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-4.1-mini",  # 换成控制台支持的模型全名
    messages=[
        {"role": "system", "content": "你是一个严谨的技术助手。"},
        {"role": "user", "content": "给我一个用于产品需求评审的提问清单（10条）。"},
    ],
)

print(resp.choices[0].message.content)

---

3）常见坑位

1. 把官网地址当成接口地址：代码里填的是 https://147ai.com/v1，不是 https://147ai.com/
2. 模型名没用“完整名”：别猜，直接复制控制台/文档里的全名
3. curl 通、SDK 不通：多半是代理/证书/环境变量/SDK 版本，先 pip install -U openai
4. Key/余额/权限：curl 不通先查这个
5. 别把问题复杂化：先跑通最小示例，再加流式输出、工具调用、RAG/Agent

---

4）为什么我偏爱“OpenAI 兼容”这条路

一句话：迁移成本低。你后续要做多模型对比、做路由、做评测，统一协议会省很多事。

资源区

我自己用的是 147ai 官网（多模型聚合、国内可用、体验更稳定，按量计费预算更可控；具体支持模型与价格以控制台为准）。

声明

本文以知识分享为主，含 147ai 官网 相关信息/示例，不构成购买建议；支持模型、Base URL、计费与可用性以 147API Apifox 接口文档 与控制台为准。