接口文档

本站接口是 OpenAI 风格，任何支持自定义 base_url + API key 的软件都能直接接。

基础信息

Base URL	https://taiyi.tech/v1
鉴权方式	请求头 `Authorization: Bearer sk-你的key`
内容类型	`Content-Type: application/json`
计费单位	1 太乙币 = 1.0 元；接口返回 `cost_milli` 是本次花费的"毫"数（1000 毫 = 1 太乙币）

查可用模型

GET /v1/models
Authorization: Bearer sk-你的key

返回当前对外的模型名、计费单位和单价。也可以用 GET /api/models（不需要鉴权）在网页上查。

图片生成

POST /v1/images/generations
Authorization: Bearer sk-你的key
Content-Type: application/json

{
  "model": "模型名",
  "prompt": "一只在雪山上的猫，电影感",
  "n": 1,
  "size": "1024x1024"
}

同步返回。上游失败会自动退款，并在响应里给出错误原因。

视频生成（异步）

视频是异步任务：先提交拿 task_id，再轮询查询，出片后自动按实际时长结算。

1. 提交任务

POST /v1/videos
Authorization: Bearer sk-你的key
Content-Type: application/json

{
  "model": "模型名",
  "prompt": "镜头缓慢推进，女子在雨中回眸",
  "duration": 5
}

→ {"task_id": "task_xxx", "status": "pending", "hold_milli": 5000}

2. 查询任务

GET /v1/videos/{task_id}
Authorization: Bearer sk-你的key

→ {"task_id": "task_xxx", "status": "running"}
→ {"task_id": "task_xxx", "status": "success", "cost_milli": 5000, "result": {"url": "..."}}

status 取值：pending / running / success / failed。失败的任务会把预扣的钱全额退回，响应里 refunded: true。

3. 可选参数

{
  "model": "模型名",
  "prompt": "镜头缓慢推进，女子在雨中回眸",
  "duration": 15,
  "ratio": "16:9",
  "reference_images": ["https://你的图床/ref-1.jpg", "https://你的图床/ref-2.jpg"],
  "reference_videos": ["https://你的图床/ref.mp4"],
  "reference_audios": ["https://你的图床/ref.mp3"]
}

字段	说明
duration	秒数，只能用该模型开放的档（见价格表模型说明），传别的档上游会拒
ratio	画面比例，`16:9` / `9:16` / `1:1` 等，按模型支持范围
reference_images	参考图，必须是公网 https 直链（自己的图床、对象存储都行）；不能用登录后才看得到的地址
reference_videos	参考视频，只有声明支持的模型生效
reference_audios	参考音频，只有声明支持的模型生效（一般还要同时给至少一张参考图）

参考图张数、视频 / 音频能不能用、时长档位，都以该模型上游的实际限制为准（价格表里每个模型后面都写了）。

错误码

HTTP	code	含义	怎么办
401	no_key / bad_key	没带 key 或 key 无效	检查请求头和 key 有没有复制全
403	key_disabled / user_banned	key 被停用或账号被封	联系管理员
402	insufficient_balance	余额不足	充值
402	quota_exceeded	该 key 自己的额度用完了	新建 key 或找管理员改额度
404	model_unavailable	模型名不对或已下架	用 `/v1/models` 查正确的名字
429	busy	同账号并发过高	减小并发，重新排队
502	upstream_failed	上游出错（已自动退款）	稍后重试，或拿 `request_id` 找管理员

对接示例

Python（openai 库）

from openai import OpenAI

client = OpenAI(base_url="https://taiyi.tech/v1", api_key="sk-你的key")
resp = client.images.generate(model="模型名", prompt="一只猫", n=1)
print(resp.data[0].url)

其他软件

任何支持"自定义接口地址"的软件，把地址填 https://taiyi.tech/v1，key 填你自己的 sk-，模型名按上面的价格表填即可。