New API 使用教学
/
OpenAI 兼容接口

New API 使用教学

从创建账号和令牌开始,完成第一次模型调用,并接入 Python、Node.js 与 Codex CLI。

同域 HTTPS 接口 7 个可用模型 更新于 2026-07-16

快速开始

注册账号

在注册页创建账号,然后登录控制台。

创建令牌

打开令牌页面,创建并妥善保存 API Key。

选择模型

首次调用建议使用 gpt-5.6-luna。

发送请求

使用 Responses API 或 OpenAI SDK 调用。

OPENAI BASE URL
https://newapi.complextcm.com/v1
首次调用
export NEW_API_KEY="sk-your-api-key"

curl https://newapi.complextcm.com/v1/responses \
  -H "Authorization: Bearer $NEW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "input": "用三句话解释什么是量化交易"
  }'
成功标志 HTTP 状态为 200,响应中的 statuscompleted

账号与令牌

创建账号

打开 注册页面,完成注册后进入控制台。账号密码和 API Key 用途不同,调用接口必须使用 API Key。

创建 API Key

  • 进入控制台的“令牌”页面。
  • 创建令牌并设置名称、有效期和额度。
  • 仅开放实际需要的模型,减少误用范围。
  • 令牌只展示或导出一次时,应立即保存在密码管理器。
账号找回 忘记密码功能要求账号已经绑定邮箱且系统 SMTP 可用。未绑定邮箱时请联系管理员处理。

模型选择

价格为标准档每 100 万 tokens 的美元价格。首次接入优先选择成本较低的模型完成联调。

模型 适合场景 输入 缓存输入 输出
gpt-5.6-sol 高质量复杂任务 旗舰 $5.00$0.50$30.00
gpt-5.6-terra 质量与成本平衡 $2.50$0.25$15.00
gpt-5.6-luna 日常问答、批量处理 推荐入门 $1.00$0.10$6.00
gpt-5.5 高质量通用任务 $5.00$0.50$30.00
gpt-5.4 代码、分析与工具调用 $2.50$0.25$15.00
gpt-5.4-mini 轻量任务与高频调用 $0.75$0.075$4.50
codex-auto-review 代码审阅 $5.00$0.50$30.00
长上下文规则gpt-5.4-mini 外,输入超过 272,000 tokens 后,输入和缓存输入价格乘 2,输出价格乘 1.5。

Responses API

新项目优先使用 /v1/responses。请求头中的 API Key 必须带 Bearer 前缀。

流式输出

curl / stream
curl https://newapi.complextcm.com/v1/responses \
  -H "Authorization: Bearer $NEW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "input": "分析沪深300指数的主要行业构成",
    "stream": true
  }'

Chat Completions 兼容接口

curl / chat completions
curl https://newapi.complextcm.com/v1/chat/completions \
  -H "Authorization: Bearer $NEW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "返回一句测试成功"}
    ]
  }'
当前仅提供标准服务档 不要设置 service_tier。当前上游会把 priorityflex 都按 default 处理,无法获得对应服务等级。

推理档位

Responses API 使用 reasoning.effort;Chat Completions 使用顶层字段 reasoning_effort。档位越高通常延迟越长、推理 tokens 越多,不保证所有任务都获得同等幅度的质量提升。

档位 兼容性 建议
none / minimal 标准值 低延迟、简单转换与格式化任务
low / medium / high 标准值 从日常任务到复杂分析逐级提高
xhigh 标准最高档 复杂代码、长链分析;SDK 与 Codex CLI 优先使用
max 当前网关扩展 HTTP API 已实测可用;严格校验枚举的客户端请改用 xhigh
ultra 不支持 会返回 HTTP 400 invalid_value,不要使用

Responses API / max

reasoning.effort
curl https://newapi.complextcm.com/v1/responses \
  -H "Authorization: Bearer $NEW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "分析这段代码的并发安全问题",
    "reasoning": {"effort": "max"}
  }'

Chat Completions / max

reasoning_effort
curl https://newapi.complextcm.com/v1/chat/completions \
  -H "Authorization: Bearer $NEW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {"role": "user", "content": "分析这段代码的并发安全问题"}
    ],
    "reasoning_effort": "max"
  }'
max 不等于承诺高于 xhigh 当前网关接受并回传 max,但具体计算预算仍由上游决定。需要跨平台兼容时使用 xhigh;不要把 ultra 当作别名。

Python 与 Node.js

pip install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NEW_API_KEY"],
    base_url="https://newapi.complextcm.com/v1",
)

response = client.responses.create(
    model="gpt-5.6-luna",
    input="给出三个量化策略回测的常见偏差",
)

print(response.output_text)

Codex CLI

将 API Key 放入环境变量,并在 Codex 配置中增加一个 OpenAI 兼容提供商。

~/.codex/config.toml
model = "gpt-5.6-luna"
model_reasoning_effort = "xhigh"
model_provider = "newapi"

[model_providers.newapi]
name = "New API"
base_url = "https://newapi.complextcm.com/v1"
env_key = "NEW_API_KEY"
wire_api = "responses"
requires_openai_auth = false
启动
export NEW_API_KEY="sk-your-api-key"
codex
模型切换 修改顶部的 model 即可。复杂代码任务可选 gpt-5.6-terragpt-5.6-sol

余额与计费

  • 系统按实际输入、缓存输入和输出 tokens 结算。
  • 当前换算为 1 美元对应 500,000 quota。
  • 新建令牌可以设置独立额度和模型白名单。
  • 可在“使用日志”查看每次请求的模型、tokens 和扣费。
  • 余额不足时可使用兑换码;在线支付方式以钱包页面实际显示为准。
控制输出成本 输出通常比输入更贵。批处理任务应限制输出长度,并尽可能复用稳定前缀以获得缓存输入价格。

故障排查

400
请求参数错误检查 JSON、模型名和接口路径。
401
令牌无效确认 Authorization 使用 Bearer 前缀,令牌没有多余空格。
403
没有模型权限检查令牌模型白名单、账号状态和 IP 限制。
429
额度或频率限制检查余额、令牌额度,降低并发后重试。
502
上游暂时不可用等待数秒重试;持续失败时更换模型并联系管理员。

最小诊断命令

列出可用模型
curl https://newapi.complextcm.com/v1/models \
  -H "Authorization: Bearer $NEW_API_KEY"

安全建议

  • API Key 只放在服务端环境变量或 Secret 管理器中。
  • 不要把 Key 提交到 Git、前端 JavaScript、截图或聊天记录。
  • 为不同应用创建不同令牌,分别设置额度、模型和 IP 范围。
  • 怀疑泄露时立即禁用旧令牌并创建新令牌。
  • 日志中不要记录完整请求头和用户敏感内容。
已复制