接口文档

文档更新时间：2026-10-20

本站接口是 OpenAI 风格：任何支持「自定义接口地址 + API Key」的软件，把地址填 https://taiyi.tech/v1、Key 填你自己的 sk- 就能直接用，不用改代码。

基础信息

调用总流程

1. GET  /v1/models               查当前上架的模型、档位和价格（模型名以它返回为准）
2. POST /v1/images/generations   图片：同步，直接返回结果
   POST /v1/videos               视频：提交任务，返回 task_id
3. GET  /v1/videos/{task_id}     视频：轮询，直到 success / failed

查可用模型

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

模型上下架、档位和价格改动会实时反映在这个接口里，客户端不要写死模型列表。 只想看看的话，网页上也能查：GET /api/models（免鉴权），或直接看 价格表。

{
  "object": "list",
  "data": [
    {
      "id": "模型名",
      "object": "model",
      "owned_by": "taiyi",
      "kind": "video",
      "unit": "per_call",
      "price_milli": 2900,
      "prices": {"15": 2900, "30": 3900},
      "durations": ["15", "30"],
      "ratios": ["16:9", "9:16", "1:1"],
      "resolutions": ["720p"],
      "min_refs": 0,
      "max_refs": 9,
      "max_videos": 0,
      "max_audios": 0,
      "max_media": 0,
      "note": "稳定可用"
    }
  ]
}

图片生成

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

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

同步返回，失败会自动退款。返回的图片地址可以直接下载（不用再带 Key）。注意它是临时地址：保留约 24 小时，之后自动清理（服务器磁盘吃紧时会更早删），请及时转存到自己的存储。

{
  "created": 1759296000,
  "data": [{"url": "https://taiyi.tech/f/xxxxxxxx.png"}],
  "request_id": "req_xxxxxxxx",
  "cost_milli": 2200
}

视频生成（异步）

视频是异步任务：先提交拿 task_id，再轮询。视频按任务计费；若模型设置了时长价格档，会按提交的时长选择本次单价，但不会将秒数乘进费用。提交时预扣一个任务的费用，完成后结算，多退少补。

1. 提交任务

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

{
  "model": "模型名",
  "prompt": "镜头缓慢推进，女子在雨中回眸",
  "duration": 15,
  "ratio": "16:9",
  "resolution": "720p"
}

→ {"task_id": "task_xxxxxxxx", "status": "pending",
   "request_id": "req_xxxxxxxx", "hold_milli": 2900}

2. 轮询任务

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

→ {"task_id": "task_xxxxxxxx", "status": "running"}
→ {"task_id": "task_xxxxxxxx", "status": "success", "cost_milli": 2900,
   "result": {"url": "https://taiyi.tech/f/xxxxxxxx.mp4"}}
→ {"task_id": "task_xxxxxxxx", "status": "failed", "refunded": true, "error": "失败原因"}

status：pending / running / success / failed。 失败的预扣会全额退回。建议每 5～10 秒查一次；重复查同一个已经结束的任务不会重复扣费。 如果某次查询返回 running 并带一个 note，说明查询通道临时不通、任务已保留，过一会儿再查即可。

视频是真实排队生成的，没有固定出片时间：快的几分钟，慢的（长时长、多张参考图）可能要几十分钟。 查任务状态不花钱，一直查到 success / failed 就行；不要用短超时去重试提交，那会重复建任务。

成功后的 result.url 和图片一样是临时地址：保留约 24 小时，请及时下载转存。

3. 可选参数

每个模型能收几张参考图、能不能收视频 / 音频、有哪些时长和比例，都以 /v1/models 返回的 min_refs / max_refs / max_videos / max_audios / durations / ratios 为准。

不符合模型能力的请求会在扣费之前直接返回 400 bad_request，错误信息里写明差在哪， 不会先扣一笔再退给你。0 / 空表示不限；请求里没带的项不校验（个别模型要求把秒数写进提示词，这类模型不用带 duration）。

参考素材要求

结果链接

计费与限额

错误码

对接示例

curl

curl -X POST https://taiyi.tech/v1/images/generations \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{"model":"模型名","prompt":"一只在雪山上的猫","n":1}'

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)

Python（requests，视频轮询）

import time, requests

H = {"Authorization": "Bearer sk-你的key"}
task = requests.post("https://taiyi.tech/v1/videos", headers=H, json={
    "model": "模型名", "prompt": "镜头缓慢推进", "duration": 15,
}).json()

while True:
    data = requests.get("https://taiyi.tech/v1/videos/" + task["task_id"], headers=H).json()
    if data["status"] in ("success", "failed"):
        break
    time.sleep(8)
print(data)

JavaScript

const res = await fetch("https://taiyi.tech/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk-你的key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ model: "模型名", prompt: "一只在雪山上的猫", n: 1 }),
});
console.log(await res.json());

其他软件

任何支持「自定义接口地址」的软件，把地址填 https://taiyi.tech/v1，Key 填你自己的 sk-， 模型名按 /v1/models 返回的 id 填即可。

安全须知