晟维AI
晟维AI API 文档
OpenAI 兼容 · 多模态模型接口
API Base URL
← 返回首页

晟维AI API ドキュメントセンター

OpenAI 互換プロトコルに基づくマルチモーダルモデル集約API。30以上の主要大規模モデルにワンストップで接続できます。本ドキュメントはクイックスタート、API呼び出し、モデル課金、FAQを網羅しています。

API ベースURL:https://api.swscnet.com/

🚀 クイックスタート#

注册、获取密钥、发起第一次 API 调用

アカウント登録とチャージ#

完成注册并为你晟维AI账户充值,即可正常调用接口。

注册账号

  1. 访问 晟维AI控制台,点击右上角 注册
  2. 填写邮箱并设置密码,完成邮箱验证;
  3. 登录后进入控制台,即可开始创建 API Key。
💡
若注册时收不到验证邮件,请检查垃圾邮件箱,或更换邮箱重试。

账户充值

API 调用按 Token 消耗计费,账户余额不足时将返回 402。平台支持以下两种充值方式:

方式一:用户自助充值

  1. 登录控制台,进入「账户充值」页面;
  2. 选择充值的套餐或自定义金额;
  3. 根据页面提示完成支付;
  4. 支付成功后余额实时到账,可在「余额明细」中查看。
⚠️
充值前请确认页面显示的站点地址与本次访问的地址一致,避免误充到其他平台。

方式二:联系客服缴费

  1. 联系客服,告知需要充值的金额;
  2. 由客服确认您所使用的模型及对应的折扣;
  3. 通过客服缴费后,客服会将相应额度充值到您的账户中。

充值后开始使用

  • 充值与注册共用同一账户,登录后即可直接调用接口;
  • 首次调用前建议先在「API Key 管理」创建密钥;
  • 若请求返回 402,说明余额不足,请再次充值。
💡
先用小额充值体验,稳定后再批量购买套餐,性价比更高。

APIキーの取得と設定#

如何安全地创建、管理、轮换你的 API 密钥。

创建 API Key

登录控制台后,在「API Key 管理」页面点击 创建密钥

bash
# 密钥格式示例
sk-abc123def456ghi789

密钥安全建议

  • 密钥等同于账户资金,切勿提交到公开仓库;
  • 建议在服务端环境变量中配置:
python
import os
api_key = os.environ.get("API_KEY")
  • 定期轮换密钥,将旧密钥在控制台删除。

密钥权限

权限说明
对话调用 chat/completions
图片调用 images/generations
语音调用 audio/transcriptions
⚠️
密钥泄露导致的损失无法追回,请务必妥善保管。

使用演示#

三分钟接入晟维AI,完成第一次 API 调用。

欢迎使用晟维AI API 聚合平台!本文档将引导你在 3 分钟内完成首次 API 调用。

第一步:注册并获取 API Key

  1. 访问 晟维AI控制台,注册账号;
  2. 进入「API Key 管理」页面,点击 创建新的密钥
  3. 复制生成的 sk- 开头的密钥,妥善保存。
⚠️
API Key 仅创建时完整展示一次,请立即保存,不要泄露给他人。

第二步:选择模型

平台已接入 DeepSeek、豆包、通义千问、Kimi、智谱 GLM 等 30+ 国产模型。可在「模型广场」按需选用,推荐使用 deepseek-v3 体验。

第三步:发起请求

使用 OpenAI 兼容接口,仅需替换 Base URL 为:

bash
https://api.swscnet.com/v1

Python 调用示例:

python
import requests

url = "https://api.swscnet.com/v1/chat/completions"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "model": "deepseek-v3",
    "messages": [{"role": "user", "content": "你好,介绍一下你自己"}]
}

resp = requests.post(url, headers=headers, json=payload)
print(resp.json()["choices"][0]["message"]["content"])

计费说明

  • 按实际消耗 Token 数计费,模型单价见 模型列表
  • 账户余额不足时请求将返回 402,请及时 充值
💡
先用小额充值体验,稳定后再批量购买套餐,性价比更高。

📖 接口文档#

对话、图片、语音等接口详细说明

余额与错误码#

API 返回的错误码含义与处理建议。

错误码一览

状态码含义处理建议
200成功-
400参数错误检查请求参数
401认证失败检查 API Key
402余额不足前往充值
429请求超限降低频率或升级套餐
500服务异常稍后重试
503服务维护关注公告

余额查询

python
import requests

url = "https://api.swscnet.com/v1/dashboard/billing/usage"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

resp = requests.get(url, headers=headers)
print(resp.json())
⚠️
当余额低于 10 元时,建议及时充值,避免影响线上业务。

对话接口 Chat Completions#

兼容 OpenAI 的对话补全接口说明。

基本信息

项目说明
请求地址POST /v1/chat/completions
认证方式Authorization: Bearer <API_KEY>
请求格式JSON
限流默认 60 次/分钟

请求参数

参数类型必填说明
modelstring模型名称
messagesarray对话消息列表
temperaturenumber采样温度 0-2
max_tokensinteger最大生成长度
streamboolean是否流式返回

请求示例

bash
curl -X POST https://api.swscnet.com/v1/chat/completions 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -H "Content-Type: application/json" 
  -d "{
    "model": "deepseek-v3",
    "messages": [{"role": "user", "content": "你好"}]
  }"

响应字段

  • id:请求唯一标识
  • model:实际使用的模型
  • choices:生成结果数组
  • usage:Token 消耗统计
💡
流式接口请将 stream 设为 true,通过 SSE 逐字返回,首字延迟更低。

🧠 模型与协议#

模型列表、上下文窗口、Token 计费规则

上下文窗口说明#

不同模型的上下文窗口与超长文本处理建议。

什么是上下文窗口

上下文窗口决定了模型一次能处理的最大 Token 数量,包含用户输入与模型输出。

各模型上下文

模型上下文窗口适用场景
DeepSeek-V3128K通用对话
豆包 Doubao-Pro256K长文档分析
MiniMax-Text-011M超长文本
Kimi K2256K长对话

超长文本建议

  1. 优先选择大上下文模型;
  2. 开启平台提供的自动分片功能;
  3. 精简历史消息,控制输入 Token。
⚠️
超过上下文窗口的请求会被拒绝,请合理设计你的 Prompt。

模型列表与 Token 计费#

平台全部模型、上下文长度与价格说明。

模型总览

平台提供文本、图像、语音等多类型模型,价格单位为 元/百万 Token

模型厂商输入价输出价上下文
DeepSeek-V3DeepSeek2.008.00128K
DeepSeek-R1DeepSeek4.0016.00128K
豆包 Doubao-Pro字节跳动0.802.00256K
通义千问 Qwen-Plus阿里云0.802.00128K
Kimi K2月之暗面4.0016.00256K

Token 计费规则

  • 输入 Token 与输出 Token 分别计费
  • 上下文中的历史消息会计入输入 Token;
  • 命中缓存的输入 Token 按缓存命中价计费,缓存价格更优惠。
text
消耗金额 = 缓存命中Token × 缓存单价 ÷ 100万 + 未命中缓存输入Token × 输入单价 ÷ 100万 + 输出Token × 输出单价 ÷ 100万
💡
长文本场景建议选用 256K/1M 上下文的模型,避免分片处理额外消耗。

❓ 常见问题#

充值、调用、报错排查等常见问题解答

常见问题#

充值、调用、计费相关的常见问题汇总。

充值的 Token 何时到账?

支付成功后余额 实时到账。如遇支付成功但未到账,请联系客服并提供订单号,我们将在 10 分钟内人工处理。

为什么调用返回 402?

402 表示账户余额不足。请前往 充值 页面购买套餐,或联系客服购买企业专用额度。

API Key 可以在多个项目使用吗?

可以。一个 API Key 可在多个项目/服务器同时使用,平台按 Token 消耗统一计费。建议不同项目使用不同 Key 以便成本归集。

流式输出如何解析?

流式接口返回 SSE 格式数据,每行以 data: 开头:

text
data: {"choices":[{"delta":{"content":"你"}}]}
data: {"choices":[{"delta":{"content":"好"}}]}
data: [DONE]

客户端按行解析并以 [DONE] 作为结束标记。

💡
更多问题欢迎联系在线客服,或发送邮件至 support@example.com。

如何开具发票#

发票申请条件、开具流程与注意事项。

如需开具发票,请按以下步骤操作:

申请条件

  • 账户已完成实名认证;
  • 累计消费金额达到开票起征金额;
  • 发票抬头信息准确无误。

申请流程

  1. 登录控制台,进入「账户管理」或「费用中心」页面;
  2. 点击「开具发票」入口,填写发票类型(增值税普通发票/电子发票)、抬头、税号及接收邮箱等信息;
  3. 提交申请后,客服将在 3~5 个工作日内完成审核与开具;
  4. 电子发票将以邮件形式发送至您填写的邮箱,可在「开票记录」中查看。

注意事项

  • 开票金额以实际消费金额为准,赠送额度部分不可开具发票;
  • 发票开具后抬头不支持更换,请务必核对后再提交;
  • 如遇开票问题,可联系在线客服协助处理。

🏠 关于平台#

平台介绍、使用说明与联系方式(用户中心「关于平台」页展示)

关于平台#

平台介绍、功能说明与联系方式

欢迎您使用我们的AI多模型智能网关平台!我们汇聚了国内外多款主流模型,以统一的 OpenAI 兼容接口对外提供调用服务,让开发者只需一次接入即可按需选用不同模型。 

平台特色 

平台采用[用户中心]和[控制台]双平台管控整个流程,方便用户及时问题反馈及问题跟踪。login.php

   [ 用户中心 ]


通过首页在线聊天窗口注册、登录该平台,方可进行套餐购买及模型选取、下单、充值。如有需要可以再次查看充值订单及开局发票申请,全流程管控平台。

注意:在[ 用户中心 ]注册的用户也可以在[ 控制台 ]使用,无需再次注册。

[ 控制台 ]


在此平台进行key的创建及查看实时使用日志及账户实时余额。

  • 模型丰富:已接入 DeepSeek、豆包、通义千问、Kimi、智谱 GLM 等 30+ 热门模型,文本、图像、语音全覆盖; 
  • 接口统一:兼容 OpenAI 接口规范,替换 Base URL 即可无缝迁移; 
  • 按量计费:按实际消耗 Token 数计费,输入输出分别计价,明码标价; 
  • 余额实时到账:支付成功后余额即时到账,可在「余额明细」中查看每一笔消耗。 
使用流程

1. [注册账号]并登录;

2. 在「API Key 管理」中创建密钥;

3. 在 [模型广场]选择需要的模型并开通;

4. 按接口文档发起调用,费用从余额中实时扣除。 

联系我们

使用问题:点击页面右下角在线客服,或查看常见问题; 

商务合作 / 企业额度:发送邮件至 swscnet-service@outlook.com或通过客服会话沟通,我们将尽快回复。

🎧
Online Support
Online · Quick reply
Welcome! Leave an email, WeChat ID, or QQ number, then start your chat.
Choose Language
简体中文 繁體中文 English 日本語 हिन्दी ไทย