一句话,替你干活。
直接说事,替你安排。
短剧工作台
从剧本到成片:一句话派活、导演台逐镜生产、管线批量排产。
号池
对话有三条线路:官方直达按原价走平台渠道;稳定线与福利线走平台自有账号池,价格更低。线路状态、折扣与运力只认服务端实时回执。
我的接入
你当前的线路偏好会随每次对话请求一并带上。线路未开通时偏好不会被保存,发送自动按官方直达口径处理。
号池目录
号池模式下可选的模型目录(服务端下发,前端不写死)。
公告
客服支持
新建工单
把问题写清楚(哪笔账单、什么时间、报什么错),客服会在这里回复你。
我的工单
客服已标记为已解决。问题解决了就点下方按钮关闭工单;还没解决直接追问,工单会重新回到待客服处理。
这张工单已关闭,不能再追问;如需继续咨询,请返回列表新开一张。
需要你处理
兑换码
输入兑换码即可入账积分余额;横线可省略、大小写不敏感,每个码只能用一次。
兑换记录
笔记
知识库
站内投递
投递
写投递
日程
充值
1 积分 = ¥1正在读取支付通道状态…
本平台不提供订阅套餐,积分按需充值。
开发者 API
用平台的 API Key 直接调用模型:兼容 OpenAI 与 Anthropic 接口,按量从余额扣费。本页文档未登录也可阅读;密钥与用量需登录后使用。
快速开始
所有请求带上你的 API Key 作 Bearer 鉴权。在「密钥」区创建 Key 后,把它填进下面的 YOUR_API_KEY 即可。Key 只在创建时显示一次,请妥善保管,不要写进公开代码仓库。
curl
curl https://xiaozhuapingtai.com/gateway-api/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "你好"}]
}'Python(openai SDK)
from openai import OpenAI
client = OpenAI(
base_url="https://xiaozhuapingtai.com/gateway-api/v1",
api_key="YOUR_API_KEY",
)
resp = client.chat.completions.create(
model="MODEL_ID",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)Node.js(openai SDK)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://xiaozhuapingtai.com/gateway-api/v1",
apiKey: "YOUR_API_KEY",
});
const resp = await client.chat.completions.create({
model: "MODEL_ID",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);MODEL_ID 从下方「模型与计价」表里选。Anthropic 客户端把 base_url 设为同一基址、改用 x-api-key 头与 anthropic-version 头调用 /messages 即可。
端点参考
| 方法与路径 | 说明 | 状态 |
|---|---|---|
POST /v1/chat/completions | 对话补全(OpenAI 兼容,支持流式) | 已开放 |
POST /v1/responses | Responses 接口(OpenAI 兼容) | 读取中… |
POST /v1/messages | Messages 接口(Anthropic 兼容) | 读取中… |
GET /v1/models | 当前 Key 可用的模型列表 | 已开放 |
GET /v1/me | 当前 Key 与所属账户信息 | 已开放 |
GET /v1/usage | 当前 Key 的用量汇总 | 已开放 |
POST /v1/embeddings | 向量嵌入 | 读取中… |
POST /v1/images/generations | 图片生成 | 读取中… |
GET /v1/images/generations/{id} | 查图片任务状态与结果地址 | 已开放 |
POST /v1/videos/generations | 视频生成(异步任务) | 读取中… |
GET /v1/videos/generations/{id} | 查视频任务状态与结果地址 | 已开放 |
GET /v1/media/files/{id} | 下载生成结果文件(图片/视频字节) | 已开放 |
POST /v1/audio/* | 语音转写与合成 | 读取中… |
标「未开放」的端点尚未上线,调用会返回错误;开放状态以平台目录实时数据为准。
模型与计价
价格按每千 token 计,单位随账户计价口径显示;输入、输出与缓存命中分别计价,实际扣费以响应里的 usage 为准。
| 模型 | 输入 / 千 token | 输出 / 千 token | 缓存 / 千 token |
|---|---|---|---|
| 加载中… | |||
媒体模型与计价(图片 / 视频)
下表为基础档单价,单位为积分(1 积分 = 1 元);更高分辨率档位价格更高,以提交回执里的 charge 为准。媒体任务提交时按目录价预冻结积分,成功后按实际结算扣除(不超过冻结额),失败整笔释放、不扣费。Key 的日/月消费限额对媒体消费同样生效(按积分计入该 Key 用量)。
| 模型 | 类型 | 基础价 | 支持的输入 |
|---|---|---|---|
| 加载中… | |||
「支持的输入」以目录实时数据为准:只有标了「图生」的模型能传参考图;不支持参考图的模型带着参考图调用会直接返回错误,不会静默忽略参考图按文字生成。
图片生成(异步任务)
图片生成是异步的:先提交拿到任务 id,再轮询查状态,成功后从结果地址下载图片。提交带 Idempotency-Key 可防重复提交(24 小时内同键同体只执行一次)。
curl https://xiaozhuapingtai.com/gateway-api/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "spicy-krea2-turbo-lora",
"prompt": "湖边小屋,清晨薄雾,写实摄影",
"resolution": "1k",
"aspect_ratio": "16:9"
}'提交成功返回 201 与任务对象 {"id": "mgj_…", "status": "queued", "charge": {"amount_micro": 321750, "currency": "points"}},其中 charge 是预冻结的微积分(1 积分 = 1,000,000 微积分)。
查状态与取图
curl https://xiaozhuapingtai.com/gateway-api/v1/images/generations/mgj_xxx \ -H "Authorization: Bearer YOUR_API_KEY"
status 依次为 queued → running → succeeded / failed。succeeded 时 data[0].url 是结果下载地址(同样带 Key 请求);failed 时看 error 的 code 与 message,冻结积分已全额释放。
参数
| 参数 | 说明 |
|---|---|
model | 必填,媒体模型 id(见上方计价表) |
prompt | 提示词;纯文字生成时必填,图生图时可作修改指令 |
resolution / aspect_ratio | 分辨率档位与画幅,按模型支持范围取值 |
negative_prompt / seed | 负面提示词 / 随机种子(可选) |
image_url 与 image_ref | 图生图源图,二选一(见下) |
strength | 重绘幅度 0–1,仅「支持的输入」标了重绘幅度的模型可用 |
参考图(图生图)
两种给法:① image_url 传公网可访问的图片地址;② image_ref 传平台引用——先前一次媒体任务的 id(mgj_…,须是同一账户已完成的任务)或平台素材引用(drama/…)。哪款模型支持图生图、能不能传 strength,看计价表的「支持的输入」。不支持的模型带参考图调用返回 422 reference_not_supported,传了不支持的参数返回 422 unsupported_parameter。
视频生成(异步任务)
视频生成与图片同一套异步契约:POST /v1/videos/generations 提交,GET /v1/videos/generations/{id} 轮询,成功后 data[0].url 下载成片。视频按秒计价,duration_sec 必填(如 5)。
curl https://xiaozhuapingtai.com/gateway-api/v1/videos/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "spicy-wan22-lora",
"prompt": "海浪缓缓拍打礁石,镜头缓慢推进",
"duration_sec": 5,
"resolution": "480p",
"image_url": "https://example.com/first-frame.jpg"
}'参考图(图生视频 / 首尾帧)
image_url / image_ref 给首帧(图生视频);再加 last_image_url / last_image_ref 给尾帧(首尾帧生成)。只有计价表标了「图生」的模型接受首帧,标了「尾帧」的才接受尾帧;不支持的带了会返回 422 reference_not_supported,不会静默丢弃参考图。
模型 spicy-h3-lora 由 MiniMax H3 提供支持(Powered by MiniMax H3);其上游对部分国家与地区有限制,受限地区的调用可能被上游拒绝并全额释放冻结。
错误码
错误响应为 JSON:{"error": {"code": "gw_…", "message": "…"}}(字段形态以实际回执为准)。按 code 处理,不要只看 HTTP 状态码。
| code | HTTP | 含义 | 处理建议 |
|---|---|---|---|
gw_auth_missing | 401 | 未携带 API Key | 加上 Authorization: Bearer 头 |
gw_auth_invalid | 401 | Key 无效或已被吊销 | 检查 Key 是否抄错;已吊销的需新建 |
gw_auth_disabled | 403 | Key 或账户被停用 | 检查密钥状态;账户问题联系平台 |
gw_auth_expired | 401 | Key 已过期 | 在密钥区续期或新建 Key |
gw_auth_ip_denied | 403 | 来源 IP 不在白名单 | 把出口 IP 加入该 Key 的 IP 白名单 |
gw_rate_limited | 429 | 超过每分钟请求上限 | 按 Retry-After 退避重试,降低并发 |
gw_concurrency_limited | 429 | 同时在飞请求过多 | 控制并发数,排队重试 |
gw_key_period_limit | 429 | 该 Key 达到日/月消费限额 | 调高限额或等周期重置 |
gw_balance_insufficient | 402 | 账户余额不足 | 充值后再调用 |
gw_quota_exceeded | 429 | 账户周期配额用尽 | 等配额重置或联系平台提升 |
gw_channel_unavailable | 503 | 该模型通道暂时不可用 | 稍后重试,或换模型 |
gw_upstream_error | 502 | 上游模型服务出错 | 指数退避重试;持续出现请反馈 |
gw_model_not_allowed | 403 | 该 Key 未被授权此模型 | 在密钥区给 Key 加上该模型 |
gw_model_not_found | 404 | 模型不存在 | 核对模型 ID(见模型与计价表) |
gw_request_invalid | 400 | 请求体不合法 | 按 message 修正参数与 JSON 格式 |
gw_job_not_found | 404 | 媒体任务不存在或不属于该 Key(引用他人任务也回此码) | 核对任务 id 与所用 Key |
gw_job_not_ready | 409 | 结果文件尚未就绪,或引用的任务还没生成完成 | 等引用任务 succeeded 后再用它做参考图 |
reference_not_supported | 422 | 该模型不支持参考图(或尾帧) | 换计价表标了「图生/尾帧」的模型,或去掉参考图 |
unsupported_parameter | 422 | 参数不被该模型支持(如 strength) | 按计价表「支持的输入」调整参数 |
content_policy | 422 | 提示词被内容策略拒绝 | 换个说法再试;此情况未扣费 |
gw_internal | 500 | 网关内部错误 | 稍后重试;持续出现请反馈并附时间 |
限流说明
每个 Key 有独立的每分钟请求上限(创建 Key 时可设)。响应头会带回当前窗口状态:
- X-RateLimit-Limit:窗口内允许的请求数上限
- X-RateLimit-Remaining:本窗口剩余可用次数
- X-RateLimit-Reset:窗口重置时间(Unix 秒)
超限返回 429(gw_rate_limited)并带 Retry-After 秒数。客户端应按 Retry-After 等待后重试,并做指数退避与抖动,不要立即高频重试。
幂等键
对可能重复提交的请求(网络重试、超时重发),带上请求头 Idempotency-Key: <你生成的唯一串>:同一 Key 在短时间内重复提交相同幂等键,只执行一次、返回同一结果,避免重复扣费。边界:幂等键只对同一 API Key 生效;不同请求体复用同一幂等键属于误用,结果不保证;幂等记录只保留有限时间,隔很久的重发会按新请求处理。
模型实时状态
状态加载中…
版本与弃用政策
当前 API 版本为 v1。平台承诺:任何接口弃用会提前至少 90 天在本页文档与站内公告通知;旧版本在新版本上线后至少并行运行 180 天才下线。破坏性变更只会进新版本,v1 内只做向后兼容的增量。
Webhook 指南
在「用量」区的 Webhook 配置里登记回调地址后,平台会在事件发生时向该地址 POST JSON:{"id": "…", "type": "事件名", "created_at": "…", "data": {…}}。事件包括:余额不足提醒(balance_low)、Key 触达限额(key_over_limit)、账单生成(bill_generated)。渠道切换、模型上下架等平台级事件由平台管理员订阅,不对单个账户投递。
验签:每次投递带 X-Webhook-Signature: sha256=<hex> 头,签名是对原始请求体用你的 Webhook Secret 做 HMAC-SHA256。务必用原始 body 验签,不要用解析后再序列化的 JSON。
import hashlib, hmac
def verify(secret: str, raw_body: bytes, header: str) -> bool:
expect = "sha256=" + hmac.new(
secret.encode(), raw_body, hashlib.sha256
).hexdigest()
return hmac.compare_digest(expect, header or "")投递失败(非 2xx 或超时)会按 1 分钟、5 分钟、30 分钟、2 小时的节奏重试,之后停止并保留在投递记录里,可在用量区手动重放。请让回调接口尽快返回 2xx,重活异步处理。
在线试调
从浏览器直调网关发一次真实请求,会按正常价格扣费。明文 Key 只存在本页内存里,不写入任何本地存储,刷新页面即消失。
响应会显示在这里。
密钥管理需要登录。登录后可创建、编辑、轮换与吊销你的 API Key。
创建密钥
填个名字就能创建。这把钥匙默认可调用平台全部模型与功能,不限额度、长期有效;想加限制再展开下面的高级设置。
这把钥匙可以调用平台全部模型与功能。
以上都可留空,之后随时能在下方列表里点「编辑」再补。
我的密钥
加载中…
用量统计需要登录。登录后可看余额、近 30 天消费与 Webhook 配置。
余额与近 30 天用量
按模型
| 模型 | 请求数 | token | 消费 |
|---|---|---|---|
| 加载中… | |||
按日消费
Webhook 配置
加载中…
新建 Webhook
投递记录
加载中…