SHIFTAI API

5 分钟接入

用 OpenAI 兼容接口接入 ShiftAI。从一组环境变量开始，完成第一条文本请求。

开始接入查看透明计费

OpenAI 兼容文本与图片开源验真

三步完成接入

01

拿到 API Key

注册并完成邮箱验证码验证，在控制台创建应用使用的 Key。

02

填写 Base URL

SDK 中填写 https://shiftautomate.com/v1，不要追加接口路径。

03

发出请求

使用 Bearer 鉴权，向 Chat Completions 发送最小请求。

准备环境变量

终端 · Bash / zsh

export SHIFTAI_BASE_URL="https://shiftautomate.com/v1"
export SHIFTAI_API_KEY="<你的key>"

Key 只放在服务端环境变量中，不要提交到 Git、网页源码或公开截图。

发出第一条请求

POST/v1/chat/completions

curl

curl "$SHIFTAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $SHIFTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "messages": [
      {"role": "user", "content": "用一句话介绍 ShiftAI API。"}
    ]
  }'

接下来去哪

接入流式输出读取 SSE 事件中的增量文本 配置常用客户端统一填写 Base URL、Key 与模型

02

CONNECTION

地址、密钥与分组

先固定地址与鉴权，再选择适合用量的分组。促销价格不属于常态分组。

Base URL 与鉴权

Base URLhttps://shiftautomate.com/v1

推荐请求头Authorization: Bearer <key>

兼容请求头x-api-key: <key>

公开端点GET /api/v1/settings/public

两种鉴权写法

curl "https://shiftautomate.com/v1/models" \
  -H "Authorization: Bearer <你的key>"

curl "https://shiftautomate.com/v1/models" \
  -H "x-api-key: <你的key>"

Base URL 已经包含 /v1。客户端会自行追加路径，不要填成 /v1/chat/completions，否则很容易形成重复路径。

三档包月分组

档位	价格	倍率	日限	月限
包月 · 入门	¥135	1.0×	$20	$400
包月 · 标准	¥250	0.9×	$30	$700
包月 · 高频	¥440	0.7×	$50	$1200

价格与后端配置实测对齐（2026-10-16），如与结帐页不一致，以结帐页为准。

分组有效期为 1 个月。默认并发为 5；RPM 未设硬性上限。注册使用 email、密码与邮件验证码，免绑卡、免实名。

03

TEXT API

文本与流式输出

同一套 OpenAI 兼容地址，可以直接使用 HTTP 请求或 OpenAI Python SDK。

Chat Completions

POST/v1/chat/completions

curl · 非流式

curl "https://shiftautomate.com/v1/chat/completions" \
  -H "Authorization: Bearer <你的key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6",
    "messages": [
      {"role": "user", "content": "请概括这段文字。"}
    ]
  }'

Python OpenAI SDK

python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["SHIFTAI_API_KEY"],
    base_url="https://shiftautomate.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[{"role": "user", "content": "请用中文回答。"}],
)
print(response.choices[0].message.content)

SSE 流式逐段读取

python · stream

stream = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[{"role": "user", "content": "逐步说明 API 鉴权。"}],
    stream=True,
)

for chunk in stream:
    text = chunk.choices[0].delta.content
    if text:
        print(text, end="", flush=True)

SSE 会连续发送事件。逐个读取 choices[0].delta.content，不要把网络数据块直接当作完整 JSON。

04

IMAGE API

图片生成

图片模型按生成张数计费，不与文本模型的输入、输出 token 混算。

按次价格

模型	每张	计费单位
gpt-image-1	$0.03	按张
gpt-image-1.5	$0.04	按张
gpt-image-2	$0.05	按张

价格与后端配置实测对齐（2026-10-16），如与结帐页不一致，以结帐页为准。

JSON 请求示例

POST/v1/images/generations

curl · JSON

curl "https://shiftautomate.com/v1/images/generations" \
  -H "Authorization: Bearer <你的key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1.5",
    "prompt": "暖色工作台上的机械键盘，产品摄影"
  }'

图片的实际扣款同样应用所在分组倍率：每张牌价 × 分组倍率。不要把图片张数换算成文本 token。

05

CLIENT SETUP

SDK 与客户端

凡是支持 OpenAI 兼容自定义地址的 SDK 或客户端，都使用同一组核心字段。

通用填写规则

Base URLhttps://shiftautomate.com/v1

API Key<你的key>

Modelgpt-5.6

base_url 只填到 /v1。不要补 /chat/completions，客户端会自动拼接接口路径。

常用客户端

C

Cursor

选择支持 OpenAI 兼容地址的配置，填入 Base URL、Key，并使用在售模型 ID。

CS

Cherry Studio

新增自定义 OpenAI 服务商，API 地址填到 /v1，再填写 Key 与模型。

L

LobeChat

在 OpenAI 兼容服务商设置中填写相同三项；模型名保持原样。

⌘

Codex

在支持自定义 OpenAI 兼容端点的配置中填写 Base URL 与 Key，以所用版本实际配置能力为准。

06

BILLING

用量与计费单位

文本按每 1M token 牌价计算，图片按张计算；两者再应用当前分组倍率。

实际扣款≈官方牌价×分组倍率

文本模型牌价

模型	输入 / 1M	输出 / 1M	缓存读 / 1M	定位
gpt-5.6	$6.25	$37.50	$0.625	主力通用／旗舰
gpt-5.6-sol	$6.25	$37.50	$0.625	高强度推理，计费同 gpt-5.6
gpt-5.5	$6.25	$37.50	$0.625	计费同 gpt-5.6
gpt-5.6-terra	$3.125	$18.75	$0.3125	平衡主力／高速
gpt-5.6-luna	$1.25	$7.50	$0.125	高频省钱

价格与后端配置实测对齐（2026-10-16），如与结帐页不一致，以结帐页为准。

缓存读单独按上表“缓存读 / 1M”列计价，不与普通输入价重复计算。

图片模型牌价

模型	每张
gpt-image-1	$0.03
gpt-image-1.5	$0.04
gpt-image-2	$0.05

价格与后端配置实测对齐（2026-10-16），如与结帐页不一致，以结帐页为准。

同一用量，三档扣款算例

使用 gpt-5.6-luna，同一笔用量为 1M 输入加 1M 输出。官方牌价合计：$1.25 + $7.50 = $8.75。

包月 · 入门$8.75$8.75 × 1.0 = $8.75

包月 · 标准$7.875$8.75 × 0.9 = $7.875

包月 · 高频$6.125$8.75 × 0.7 = $6.125

以上为同用量倍率算例；实际扣款约等于牌价乘倍率，如与结帐页不一致，以结帐页为准。

07

VERIFY

验真与信任

牌价、倍率与上限公开之外，你还可以用纯 Python 标准库脚本自行验证路由表现。

开源 verify_model.py

仓库：github-shiftai/verify_model.py。脚本零依赖，包含三项检查：

01

identity

确定性题目比对

02

reasoning

推理题比对

03

latency

连跑 5 次，输出 p50 / p95

复制即跑

python3 verify_model.py --base-url https://shiftautomate.com/v1 --key <你的key> --model gpt-5.6 --check all

每晚夜巡日报

自动夜巡23:02每晚执行并公开日报

p500.19s2026-10-16 实测

p950.20s2026-10-16 实测

p50 / p95 是站点 API 的网络往返时间，不是模型推理延迟。日报公开可用率、延迟与异常。

08

TROUBLESHOOTING

错误与排障

先看状态码，再核对地址、鉴权与并发。保留脱敏后的响应内容，避免盲目重试。

401

鉴权缺失或无效

/v1/models 未带 Key 返回 401 是正常行为。确认使用 Authorization: Bearer <key> 或 x-api-key。

404

路径不存在

优先检查 Base URL 是否已经包含 /v1。重复形成 /v1/v1 是最常见的路径错误。

429

请求受到限制

检查默认并发 5 是否已占满，并按响应信息退避。RPM 未设硬性上限，不代表上游不会返回限制。

TIMEOUT

请求超时

超时不等于服务端未收到请求。先查询用量与请求结果，再决定是否重试，避免重复产生费用。

排障时提供发生时间、请求路径、模型 ID、状态码和脱敏错误；不要提供完整 Key、Authorization、Cookie 或登录凭证。

09

LIMITS

限制与说明

能力边界直接写清楚。下面这些项目目前不在 ShiftAI 的服务范围或常态承诺内。

01

只接入 OpenAI 系模型

Anthropic／Claude、Google／Gemini、DeepSeek 目前没有在售渠道。

02

没有视频生成能力

这不是文档遗漏，而是当前尚未提供。

03

微信支付，人工确认到账

到账会等待；当前 payment_enabled=false，不支持自动收款。

04

目前没有注册赠金

旧的 $0.10 活动已到期。最低充值为 $1。

05

不做 SLA 承诺

品牌运营时间短，不使用尚无长期记录背书的可用率数字。

06

促销倍率不是常态价格

限时促销组的 0.45× 与 Codex 0.01× 只在活动期间适用，以控制台显示为准。