StdAPI 使用文档返回主站 →

StdAPI 使用文档

统一 AI 大模型 API 网关 · 最后更新：2026-10-12

目录

  1. 快速开始
  2. 核心概念：分组
  3. 计费与额度
  4. API 调用
  5. 视频生成
  6. 常见错误速查
  7. 使用条款

一、快速开始

1. 注册账号

访问 https://stdapi.xin 注册。需要完成邮箱/用户名注册，并填写图形验证码。

2. 充值

钱包 → 充值，选择支付宝或微信，最低充值 1 美元。支付完成后额度自动到账。

3. 创建 API Key

控制台 → 令牌 → 新建令牌

创建时必须选择分组（Group）。分组决定你能用哪些模型、按什么价格计费。

⚠️ 分组选错了会导致调用失败。 请先读第二章。

创建后会得到一串以 sk- 开头的密钥，只显示一次，请立即保存。

4. 第一次调用

curl https://stdapi.xin/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Base URL： https://stdapi.xin/v1

二、核心概念：分组

什么是分组

同一个模型（比如 Claude），我们可能通过多条不同的上游线路接入。分组就是"线路"。

不同线路的差别在于：

维度 说明
可用模型 某些模型只在特定分组里有
价格 同为满血模型，特价渠道可能只要官价的一半
稳定性 官方直连通常最稳，第三方渠道波动更大
使用限制 部分分组仅限特定客户端（如 Claude Code、Codex）

分组倍率怎么读

每个分组有一个倍率（GroupRatio）：

全部分组一览

分组 倍率 特点
default 1.0 默认分组，覆盖通用模型与视频生成
Claude 官渠（官方直连） 0.821 Anthropic 官方 KEY 直连，最稳
Claude Max（仅限CC） 0.329 官方 Max 满血，仅限 Claude Code / Claude Desktop 客户端
Claude Max（外接版） 0.361 同上，但可外接脚本、支持更多场景
Claude Plus（精品） 0.164 第三方 Claude，可平替官方 Max，性价比最高
Codex Pro（仅限Codex） 0.115 ChatGPT Pro 号池，仅限 Codex APP / CLI，禁止生图
Codex Pro（外接版） 0.131 同上，可外接脚本、支持生图
GPT 官方直连 0.46 Azure 企业渠道，满血 GPT，无内容限制
Gemini（官方直连） 0.427 Google Vertex 官方 API
Gemini（特价渠道） 0.164 第三方渠道，缓存命中率低，不适合需要缓存的场景
DeepSeek（官方直连） 1.035 官方 API，同步官方峰谷价
DeepSeek（大厂直供） 0.575 大厂直供满血版，稳定可生产
kimi（云厂商渠道） 0.863 云厂商部署，速度快、并发高
kimi（特价渠道） 0.575 特价，1M 长上下文
智谱 Zhipu（云厂商渠道） 0.863 云厂商部署，并发更高
智谱 Zhipu（特价渠道） 0.575 特价渠道，1M 长上下文
千问 Qwen（特价） 0.69 特价渠道
MiniMax（特价） 0.575 满血 M3，1M 上下文，速度快
混元 Hunyuan（特价） 0.575 腾讯混元特价
Muse（特价） 0.575 Meta Muse 特价
小米 MiMo（特价） 0.863 小米 MiMo 特价
Grok 企业版 0.164 Grok Heavy 号池，支持图片与视频生成
ChatGPT 生图分组 1.15 gpt-images-2 / gpt-images-2.5 专用

选择建议：先确认模型在哪个分组里有，再在同模型的多条线路里选倍率低的。日常编码推荐 Claude Plus（精品）或 Codex Pro（外接版）。

三、计费与额度

额度单位

两种计价方式

方式 适用 怎么算
按量计费 对话、补全、嵌入等 单价 × 输入 token × 倍率 + 单价 × 输出 token × 倍率
按次计费 图片生成、视频生成 每次固定价格 × 分组倍率

查看消耗

控制台 → 日志 可以看到每一次调用的：模型、token 数、消耗额度、耗时。

四、API 调用

Base URL

https://stdapi.xin/v1

鉴权

所有请求都带 API Key：

Authorization: Bearer sk-你的密钥

支持的接口

对话与文本

端点 说明
POST /v1/chat/completions 对话（OpenAI 格式，最常用）
POST /v1/completions 文本补全
POST /v1/messages Claude 原生格式
POST /v1/responses Responses API
POST /v1/embeddings 向量嵌入
POST /v1/rerank 重排序
POST /v1/moderations 内容审核

图片与音频

端点 说明
POST /v1/images/generations 文生图
POST /v1/images/edits 图片编辑
POST /v1/audio/speech 语音合成
POST /v1/audio/transcriptions 语音转文字
POST /v1/audio/translations 语音翻译

模型列表

curl https://stdapi.xin/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

Python 示例（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://stdapi.xin/v1"
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)

Node.js 示例

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'sk-你的密钥',
  baseURL: 'https://stdapi.xin/v1',
})

const resp = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: '你好' }],
})
console.log(resp.choices[0].message.content)

接入第三方客户端

本服务兼容 OpenAI 协议，绝大多数客户端都能直接用。配置方式：

字段 填什么
Base URL / API 地址 https://stdapi.xin/v1
API Key 你的 sk- 密钥
模型 从模型广场选，注意分组

常见客户端：Cursor、Cline、Continue、Cherry Studio、ChatBox、NextChat、沉浸式翻译、Claude Code、Codex CLI 等。

⚠️ Claude Code / Codex CLI 请务必使用对应分组，否则会调用失败。

五、视频生成

可用模型

目前视频生成仅在 default 分组 提供，共 4 个模型：

模型 必须选择的画质
sd-2.0-480p 480p
sd-2.0-720p 720p
sd-2.0-1080p 1080p
sd-2.5-720p ⭐ 720p

⚠️ 最重要的一条规则：模型名里的分辨率，必须和界面上选择的画质一致。

例如选了 sd-2.0-480p，画质就必须选 480p。选了 720p 会报错 invalid_resolution。

推荐：日常使用 sd-2.5-720p + 720p，是当前最稳的组合。

操作流程

  1. 进入网站 视频 页面
  2. 选择模型（默认分组）和画质
  3. 输入提示词
  4. （可选）上传参考图 —— 图片会安全存储在自家对象存储中
  5. 选择时长（最长 60 秒）
  6. 提交生成

生成时长

参考值：5 秒视频约需 4～8 分钟。到 50% 左右是最慢的阶段，请耐心等待，不要重复提交。

计费

视频按次计费，费用在提交时预扣。如果生成失败，费用会自动全额退回。

视频有效期

⚠️ 生成完成后请尽快下载保存。

视频结果存放在上游临时存储，访问链接约 3 天后失效。本平台不留存副本，过期后无法找回，需要重新生成（重新计费）。

六、常见错误速查

报错信息 原因 怎么解决
Invalid token / 401 密钥错误、被禁用或已删除 到「令牌」页面确认状态是否"已启用"
无可用渠道 / no available channel 该分组下没有模型，或分组选错 换一个包含目标模型的分组
当前分组 %s 下对于模型 %s 无可用渠道 同上 检查模型与分组的匹配关系
insufficient quota / 额度不足 余额不够 到钱包充值
invalid_resolution 视频画质与模型名不匹配 见第五章的分辨率规则
Videos API is not supported for this platform 在视频页选了对话模型 只能用 sd- 开头的 4 个视频模型
invalid api platform 该模型所在渠道不支持视频生成 同上，改用 sd-* 系列
Rate limit / 429 请求过于频繁 降低频率后重试
请求超时 模型响应慢或提示词过长 缩短输入、换更快的分组
Claude Code 报鉴权失败 用了非 Claude 分组 切到「Claude Max（仅限CC）」等对应分组

仍然解决不了？ 把完整报错信息和调用时间发给客服，我们能从日志里精确定位。

七、使用条款

  1. 服务性质：本平台为 AI 模型 API 中转服务，不提供模型本身。
  2. 使用限制：
    • 禁止用于任何违法违规用途
    • 禁止转售、二次分发本平台 API Key
    • 禁止滥用（高频刷量、批量注册等）
    • 部分分组（如 Codex Pro 仅限 Codex、Claude Max 仅限 CC）仅限指定客户端使用，违规使用可能导致账号封禁
  3. 额度与退款：
    • 充值额度不可提现
    • 按量计费部分不退款
    • 视频等按次计费，生成失败自动退款
  4. 服务可用性：上游线路可能存在波动，我们会尽量保证质量，但不对不可抗力导致的不可用承担赔偿责任。
  5. 账号安全：请妥善保管 API Key。因密钥泄露导致的损失由用户自行承担。

八、联系与支持

反馈问题时请附带：调用时间、使用的模型、分组、完整报错信息，可以大幅加快定位速度。

本文档随服务调整更新。

本文档随服务调整更新 · StdAPI