Claw AI
正在确认登录状态…
网络已断开,消息发送已暂停(草稿照常保存)。
临时会话:不保存、不同步、不会被记住。

一句话,替你干活。

直接说事,替你安排。

松开鼠标,把文件加为附件
线路
模型服务尚未接通,接入后将显示可用模型。
图片查看

短剧工作台

从剧本到成片:一句话派活、导演台逐镜生产、管线批量排产。

号池

对话有三条线路:官方直达按原价走平台渠道;稳定线与福利线走平台自有账号池,价格更低。线路状态、折扣与运力只认服务端实时回执。

线路状态加载中…

我的接入

你当前的线路偏好会随每次对话请求一并带上。线路未开通时偏好不会被保存,发送自动按官方直达口径处理。

当前线路偏好
—
席位绑定
—
本期用量
—
到期信息
—

号池目录

号池模式下可选的模型目录(服务端下发,前端不写死)。

目录加载中…

公告

加载中…

客服支持

我的工单

加载中…

需要你处理

兑换码

当前余额…积分

输入兑换码即可入账积分余额;横线可省略、大小写不敏感,每个码只能用一次。

兑换记录

加载中…

笔记

加载中…

知识库

…
新建条目

站内投递

加载中…

投递

写投递

投递不收费(0 积分)

日程

日一二三四五六

充值

1 积分 = ¥1
当前余额…
¥→

正在读取支付通道状态…

本平台不提供订阅套餐,积分按需充值。

开发者 API

用平台的 API Key 直接调用模型:兼容 OpenAI 与 Anthropic 接口,按量从余额扣费。本页文档未登录也可阅读;密钥与用量需登录后使用。

API 基址 https://xiaozhuapingtai.com/gateway-api/v1

快速开始

所有请求带上你的 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/responsesResponses 接口(OpenAI 兼容)读取中…
POST /v1/messagesMessages 接口(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 状态码。

codeHTTP含义处理建议
gw_auth_missing401未携带 API Key加上 Authorization: Bearer 头
gw_auth_invalid401Key 无效或已被吊销检查 Key 是否抄错;已吊销的需新建
gw_auth_disabled403Key 或账户被停用检查密钥状态;账户问题联系平台
gw_auth_expired401Key 已过期在密钥区续期或新建 Key
gw_auth_ip_denied403来源 IP 不在白名单把出口 IP 加入该 Key 的 IP 白名单
gw_rate_limited429超过每分钟请求上限按 Retry-After 退避重试,降低并发
gw_concurrency_limited429同时在飞请求过多控制并发数,排队重试
gw_key_period_limit429该 Key 达到日/月消费限额调高限额或等周期重置
gw_balance_insufficient402账户余额不足充值后再调用
gw_quota_exceeded429账户周期配额用尽等配额重置或联系平台提升
gw_channel_unavailable503该模型通道暂时不可用稍后重试,或换模型
gw_upstream_error502上游模型服务出错指数退避重试;持续出现请反馈
gw_model_not_allowed403该 Key 未被授权此模型在密钥区给 Key 加上该模型
gw_model_not_found404模型不存在核对模型 ID(见模型与计价表)
gw_request_invalid400请求体不合法按 message 修正参数与 JSON 格式
gw_job_not_found404媒体任务不存在或不属于该 Key(引用他人任务也回此码)核对任务 id 与所用 Key
gw_job_not_ready409结果文件尚未就绪,或引用的任务还没生成完成等引用任务 succeeded 后再用它做参考图
reference_not_supported422该模型不支持参考图(或尾帧)换计价表标了「图生/尾帧」的模型,或去掉参考图
unsupported_parameter422参数不被该模型支持(如 strength)按计价表「支持的输入」调整参数
content_policy422提示词被内容策略拒绝换个说法再试;此情况未扣费
gw_internal500网关内部错误稍后重试;持续出现请反馈并附时间

限流说明

每个 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,重活异步处理。