使用文档

SKIAPI 是一个第三方 AI 模型 API 聚合网关：一个密钥，统一访问多个模型，接口兼容 OpenAI、Anthropic、Gemini 三种协议，现有的 SDK 与客户端大多可直接接入，不需要为每个上游单独配置。

接入点

地址	说明
`https://api.skiapi.dev`	主接入点（推荐日常使用）
`https://gw.skiapi.dev`	备用接入点，与主接入点等价，主接入点异常时可切换

两个接入点访问的是同一套服务与同一份密钥，模型、计费、限流口径完全一致。

快速开始

1. 获取令牌

登录控制台（首页右上角进入），在「令牌」页新建一个 API Key。令牌只在创建时完整显示一次，请立即保存；它与你的账号权限等价，不要发到群里、写进公开仓库或截图分享。

2. 发起第一次调用（OpenAI 兼容格式）

curl https://api.skiapi.dev/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'

模型中填当前在供列表里的名字：完整清单见模型与价格页，或控制台的模型列表；调用时以实际返回为准。

3. 接入现有工具

OpenAI SDK / 兼容客户端：Base URL 填 https://api.skiapi.dev/v1，API Key 填你的令牌，其余不动。
Anthropic / Claude Code：设置两个环境变量后无需改代码——
ANTHROPIC_BASE_URL=https://api.skiapi.dev
ANTHROPIC_AUTH_TOKEN=sk-你的令牌
Gemini 协议：把客户端的 API Base 指向 https://api.skiapi.dev，使用 /v1beta 路径族与你的令牌即可。

三种协议对应的是同一份密钥与同一份额度——换工具不用换配置。

模型与计费

可用的模型、分组与价格，以模型与价格页（实时读取）为准。
计费为真实统一价：按各厂商官方挂牌价计费——按 token 的模型区分输入/输出计价，图片与视频模型按次计价，全站统一、无分组加价。
账号余额由管理员发放：新账号默认余额为 0，需要额度请联系管理员开通（联系方式见隐私政策页）；余额为 0 时请求会被拒绝（HTTP 403）。
计费口径如有调整，会按用户协议提前公告。

视频生成

支持通过 grok-imagine-video 生成短视频（文生视频）。整个流程分三步：创建任务 → 轮询状态 → 取回视频。

1. 创建任务

curl https://api.skiapi.dev/v1/videos \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "a red ball rolling on a table",
    "duration": 1,
    "resolution": "720p"
  }'

返回任务对象，含 id 与 status：

{"id":"task_…","status":"queued"}

2. 轮询状态

curl https://api.skiapi.dev/v1/videos/$ID \
  -H "Authorization: Bearer $KEY"

status 依次为 queued → in_progress → completed；失败则为 failed。生成过程约 1 分钟，建议每 5 秒轮询一次。

3. 取回视频

curl https://api.skiapi.dev/v1/videos/$ID/content \
  -H "Authorization: Bearer $KEY" \
  -o output.mp4

返回 video/mp4 二进制内容，直接保存为 .mp4 即可播放。

使用边界

分辨率：当前账号池仅支持 720p；其他档位会返回 503。
时长：1–6 秒。本池上限 6 秒，超出自动按 6 秒处理。
计费：按次计费（当前 $0.05/次），以模型与价格页实时为准。

浏览器使用

不想写代码可以直接用视频生成页：把控制台的令牌粘贴进去即可，令牌只保存在本机浏览器，不会上传。

常见问题

401 / 无效令牌

检查三件事：令牌是否完整复制（含前缀）；请求头是否为 Authorization: Bearer <令牌>；令牌是否已被删除或超过有效期。

429 / 请求过多

短时间调用过于频繁会触发限流。降低并发或稍后重试即可；持续触发说明用量形态异常，可发邮件说明场景。

连接超时 / 中断

长回答建议开启流式（"stream": true）；个别模型高峰期排队时首字节会变慢，属正常现象。持续不可用请附上请求 ID 反馈。

为什么有些模型偶尔返回上游错误？

本服务是聚合网关，请求最终由上游模型渠道完成。上游限流、风控或临时故障会以相应错误透传，稍后重试通常即可恢复。

使用边界

发送内容前请阅读用户协议（禁止事项与责任边界）与隐私政策（我们记录什么、不记录什么）。两句话版本：我们不保存你的对话内容，只记计量与排障所需的元数据；请勿用于违法违规用途，也请勿将本服务转售或对外中转。

相关：用户协议 · 隐私政策 · 回到首页