API DOCUMENTATION
ChatGPT API 中转与 OpenAI 兼容接入教程
ChatGPT 是面向用户的产品界面，OpenAI 兼容 API 则用于程序调用。以下示例说明基础地址、Bearer 鉴权和聊天补全请求格式；实际 GPT 模型名称、价格、额度与可用状态以黑洞中转站控制台为准。
Base URL
https://www.text168.com/v1
鉴权方式
Authorization: Bearer API_KEY
模型名称
复制控制台当前显示的模型 ID，不要自行猜测。
准备 API 密钥
登录平台后创建项目专用的 API 密钥。密钥通常只在创建时完整显示，请保存在环境变量或受权限保护的配置中。下面示例使用 TEXT168_API_KEY，避免直接把真实密钥写进命令历史或源码。
# Linux / macOS
export TEXT168_API_KEY="YOUR_API_KEY"
# PowerShell
$env:TEXT168_API_KEY="YOUR_API_KEY"使用 curl 验证
先从短请求开始，并把 MODEL_ID_FROM_CONSOLE 替换为控制台中的真实模型 ID。
curl https://www.text168.com/v1/chat/completions \
-H "Authorization: Bearer $TEXT168_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID_FROM_CONSOLE",
"messages": [
{"role": "user", "content": "请回复：连接成功"}
]
}'返回成功后，可在平台调用记录中核对请求时间、模型、状态和实际用量。Windows PowerShell 用户也可以使用支持 JSON 请求体的 HTTP 客户端，关键是保持相同 URL、请求头和 JSON 字段。
Python 客户端配置
如果所用 SDK 支持自定义 OpenAI 兼容基础地址，可按下面方式设置。示例从环境变量读取密钥，避免将凭证提交到版本控制。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["TEXT168_API_KEY"],
base_url="https://www.text168.com/v1",
)
response = client.chat.completions.create(
model="MODEL_ID_FROM_CONSOLE",
messages=[
{"role": "user", "content": "请回复：连接成功"}
],
)
print(response.choices[0].message.content)不同 SDK 版本对扩展参数的支持可能不同。遇到问题时先删除非必要参数，用最小请求确认基础连接。