零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略

新疆幻城网安科技
公益大模型API

使用教程文档

平台地址:https://api.hcnsec.cn/

控制台地址:https://api.hcnsec.cn/console

文档版本:V2.0
编制日期:2026年7月10日

本教程文档由:

王子航编辑

王欣欣校对优化

杨雨琪发布

感谢工作人员及各位对平台的支持和付出!

目录

一、平台概述 1

1.1核心特性 1

1.2支持的API接口 2

二、快速入门 3

2.1注册与登录 3

步骤一:访问控制台 3

步骤二:注册账户 3

步骤三:登录系统 4

2.2获取APIKey 5

创建APIKey的步骤 5

2.3第一次API调用 10

使用curl测试 10

使用Python测试 10

三、控制台功能详解 12

3.1仪表盘(数据看板) 12

功能说明 12

操作指引 12

3.2令牌管理(APIKey管理) 13

令牌列表 13

令牌操作 17

安全建议 17

3.3充值 17

邀请充值 17

在线充值 18

退款政策 19

3.4日志与用量统计 20

请求日志 20

额度明细 21

3.5模型广场 21

功能说明 21

3.6聊天测试 22

使用方法 22

四、API接口调用详解 24

1.基础信息 24

2.核心接口列表 24

3.接口详细说明 24

3.1对话补全接口(/v1/chat/completions) 24

3.2嵌入接口(/v1/embeddings) 25

3.3图像生成接口(/v1/images/generations) 25

3.4图像变体接口(/v1/images/variations) 26

3.5语音合成接口(/v1/audio/speech) 26

3.6模型列表接口(/v1/models) 26

4.重要注意事项 27

五、支持的模型与供应商 28

一、智能路由 29

二、DeepSeek系列 29

六、Gemini系列(Google) 30

七、Kimi系列(月之暗面) 30

八、MiniMax系列 30

九、讯飞星火Spark系列 30

十、快手Kat系列 30

十一、阶跃星辰Step系列 30

十二、StepAudio语音系列 31

平台当前共支持35个AI大模型,涵盖: 31

六、 常见使用场景示例 32

从API平台直接配置教程: 32

6.1在Claudecode中使用 36

6.2在codex中使用 37

6.3在Python代码中使用 37

6.4在Node.js代码中使用 38

七、常见问题与故障排查 39

八、合规与安全说明 42

8.1合规运营 42

8.2企业资质 42

8.3用户法律义务 42

8.4联系方式 43

一、平台概述

新疆幻城网安科技公益大模型API(https://api.hcnsec.cn/)是一个统一的大模型API平台,由新疆幻城网安科技有限责任公司运营。平台将30余家国内外主流大模型供应商的API统一封装为OpenAI兼容格式,提供一站式接入解决方案,帮助开发者和企业快速、便捷地使用各类AI能力。

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图

1.1核心特性

  • 统一API接口标准:兼容OpenAI接口格式,无需修改代码即可切换不同模型
  • 智能路由调度:自动选择最优模型通道,确保服务稳定性和响应速度
  • 多模型统一管理:一站式调用GPT、Claude、DeepSeek、Qwen、GLM、Kimi等主流模型
  • 实时监控告警:7×24小时保障服务可用性
  • 详细用量统计:精准成本控制与消费明细追踪
  • 合规运营保障:所有模型均为官方企业,国内模型均已通过国家网信办备案

1.2支持的API接口

平台支持以下OpenAI兼容接口端点:

接口端点 功能说明 请求方法
/v1/chat/completions 对话补全(核心接口) POST
/v1/responses Responses接口 POST
/v1/responses/compact 紧凑版Responses接口 POST
/v1/messages ClaudeMessages格式接口 POST
/v1beta/models 获取可用模型列表 GET
/v1/embeddings 文本嵌入/向量化 POST
/v1/rerank 重排序 POST
/v1/images/generations 图像生成 POST
/v1/images/edits 图像编辑 POST
/v1/images/variations 图像变体 POST
/v1/audio/speech 语音合成(TTS) POST
/v1/audio/transcriptions 语音转写(ASR) POST

提示:所有接口的BaseURL为https://api.hcnsec.cn,只需将官方SDK中的base_url替换即可。

二、快速入门

2.1注册与登录

步骤一:访问控制台

打开浏览器,访问https://api.hcnsec.cn/console,进入平台控制台登录页面。

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图1

步骤二:注册账户

  1. 在登录页面点击”注册”按钮

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图2

  1. 填写用户名
  2. 设置登录密码

4.完成邮箱验证

5.点击”注册”按钮完成注册

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图3

步骤三:登录系统

1.在登录页面输入注册时使用的用户名或邮箱

2.输入密码

3.勾选用户协议,点击”登录”按钮

4.登录成功后将自动跳转至控制台仪表盘

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图4

2.2获取APIKey

APIKey是调用平台接口的凭证,格式为sk-xxx。每个用户可以创建多个APIKey,分别用于不同的应用场景,方便管理和额度控制。

创建APIKey的步骤

1.登录控制台后,在左侧导航栏点击”令牌”菜单 零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图5

2.点击”添加令牌”或”创建新令牌”按钮

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图6

  1. 填写令牌名称(便于识别用途,如”我的博客助手”)

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图7

  1. 令牌分组选择默认(如果您购买了套餐,那在这边选择对应的套餐好)

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图8

  1. 设置过期时间(可选,不设置则永不过期)

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图9

  1. 新建数量取决与用户,默认为1
  2. 设置额度限制(可选,建议勾选无限额度)

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图10

  1. 访问限制设置由用户进行自行选择,模型限制列表以及IP白名单

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图11

  1. 点击”提交”按钮完成创建

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图12

  1. 创建成功后,系统会显示完整的APIKey(sk-xxx格式),请不要随意泄露

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图13

重要提示:

APIKey请务必妥善保管。如果密钥泄露,请立即在令牌管理页面禁用或者删除该密钥并重新创建。(必要时联系网站管理员进行封禁操作)

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图14

2.3第一次API调用

获取APIKey后,可以使用以下方式快速测试接口是否正常工作:

使用curl测试

在终端中执行以下命令(将sk-your-api-key替换为你实际的APIKey):

Invoke-WebRequest-Uri”https://api.hcnsec.cn/v1/chat/completions”-MethodPOST-ContentType”application/json”-Headers@{“Authorization”=”Bearersk-your-api-key}-Body'{“model”:”auto”,”messages”:[{“role”:”user”,”content”:”你好,请介绍一下你自己”}],”stream”:false}’-UseBasicParsing

使用Python测试

安装OpenAIPythonSDK:

pipinstallopenai

运行以下代码:

fromopenaiimportOpenAI

fromopenaiimportAPIError,AuthenticationError,RateLimitError

api_key=”sk-yourkey”

base_url=”https://api.hcnsec.cn/v1″

#初始化客户端

client=OpenAI(api_key=api_key,base_url=base_url)

deftest_api_key():

print(“正在测试API密钥…”)

try:

models=client.models.list()

 

first_model=models.data[0].idifmodels.dataelse”未知模型”

print(f”✅密钥有效!连接成功。”)

print(f” 可用模型示例:{first_model}”)

 

exceptAuthenticationError:

print(“❌验证失败:API密钥无效或已过期。”)

exceptRateLimitError:

print(“⚠️连接成功,但触发了速率限制。密钥本身是有效的。”)

exceptAPIErrorase:

print(f”❌API错误:{e.status_code}-{e.message}”)

exceptExceptionase:

print(f”❌发生未知错误:{e}”)

if__name__==”__main__”:

test_api_key()

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图15

三、控制台功能详解

控制台是平台的核心管理界面,登录后可通过左侧导航栏访问各功能模块。不同角色(管理员/普通用户)看到的菜单项可能有所不同。以下逐一详解各模块。

3.1仪表盘(数据看板)

仪表盘是登录后的默认首页,提供平台使用数据的全局概览,帮助用户快速了解当前账户的使用状况。

功能说明

资源消耗统计:展示Token消耗总量、消耗金额关键指标

用量趋势图:以折线图形式展示近期的Token消耗和请求量变化趋势

调用次数排行:展示调用量最多的模型排名,帮助了解主要使用场景

消耗分布:展示不同模型的费用占比,便于成本分析和优化

Api测用:提供令牌创建、充值等高频操作的快捷入口按钮

操作指引

1.登录控制台后默认进入仪表盘页面

2.页面顶部展示核心数据卡片,包括今日消耗、总请求次数等

3.页面中部展示用量趋势图表,右上角可切换时间范围(今日/7天/30天)

4.页面下方可以切换展示模型使用排行和成本分布

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图16 零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图17

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图18

3.2令牌管理(APIKey管理)

令牌管理模块用于创建、查看和管理APIKey。每个令牌代表一个独立的API访问凭证,可以为不同应用或场景创建不同的令牌,实现精细化权限控制和额度管理。

令牌列表

令牌列表页面展示当前用户创建的所有令牌,包含以下信息:

  • 令牌名称
  • 状态
  • 分组
  • 令牌Key(隐藏显示,如sk-****xxxx)
  • 可用模型
  • ip限制
  • 创建时间
  • 过期时间
  • 状态(启用/禁用)
  • 编辑/删除

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图19创建令牌

点击”添加令牌”按钮,在弹出窗口中配置以下参数:

参数 说明 是否必填
名称 为令牌取一个便于识别的名称,如”生产环境-博客助手”
令牌分组 一般默认,如果购买了套餐,不要忘记切换
过期时间 设置令牌的过期日期,不填则默认永不过期
无限额度 勾选后令牌额度不受限制
允许的IP 设置IP白名单,限制仅指定IP可使用此令牌
允许的模型 设置模型白名单,限制此令牌仅可调用指定模型

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图20

令牌操作

复制Key:点击复制按钮,将令牌Key复制到剪贴板(仅显示部分,完整Key创建时可见,后面存在显示按键)

禁用/启用:临时禁用令牌,禁用后使用该Key的所有请求将被拒绝

删除:永久删除令牌,删除后不可恢复,使用该Key的所有请求将失败

额度调整:修改令牌的额度上限

安全建议

  • 为不同应用创建不同令牌,避免共用同一个Key
  • 设置合理的额度上限,防止意外消耗
  • 定期轮换APIKey,避免长期使用同一密钥
  • 如果密钥泄露,立即删除并重新创建
  • 利用IP白名单功能限制访问来源

3.3充值

充值模块用于为账户增加使用额度。平台支持邀请充值和在线支付两种方式。

邀请充值

在钱包中找到邀请链接,通过此链接注册的人员均可以添加余额,直接划转到自身余额即可

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图21

在线充值

平台支持通过在线支付方式充值。选择充值金额后,系统会生成支付二维码或跳转到支付页面,支持微信支付、支付宝等方式。支付完成后额度自动到账。

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图22

退款政策

  • 充值未使用:用户充值后7日内,如未使用任何API服务,可申请全额退款
  • 部分使用:已使用部分按实际消耗量扣除,剩余余额按市场价格计算可申请退款
  • 服务故障:因平台原因导致服务不可用超过24小时,可申请对应时长的补偿
  • 退款方式:原路退回至支付账户,到账时间1-7个工作日
  • 申请渠道:通过后台工单系统提交退款申请
  • 不予退款情形:虚拟商品不支持无理由退款;恶意滥用服务、违反用户协议的账户不予退款

3.4日志与用量统计

日志模块记录每一次API调用的详细信息,是用量追踪、成本分析和问题排查的重要工具。

请求日志

每次API调用都会生成一条日志记录,包含以下信息:

字段 说明
请求时间 API调用的具体时间
分组 令牌所在的分组
令牌 直接显示的令牌名称
类型 一般为消费
模型 调用的模型名称
用时 单次请求使用的时间
输入 输入部分的Token数量
输出 输出部分的Token数量
花费 本次请求消耗的额度/金额/订阅折扣
ip记录 记录ip当前使用令牌

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图23

额度明细

额度明细逐条展示额度的充值与消耗记录,帮助用户清晰追踪每一笔额度的变动情况。支持按时间范围、类型(充值/消耗)筛选。

3.5模型广场

模型广场以可视化方式展示平台支持的所有可用模型,方便用户浏览和选择合适的模型。

功能说明

  • 模型分类浏览:按供应商(如DeepSeek、Qwen、GLM等),计费类型,标签,端点类型等分类展示
  • 模型详细信息:展示每个模型的上下文长度、输入/输出价格等参数
  • 模型状态标识:显示模型当前是否可用
  • 快速测试:部分模型支持直接在模型广场中发起测试调用

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图24

3.6聊天测试

聊天测试模块提供一个在线对话界面,允许用户在控制台中直接与AI模型对话,用于快速测试模型效果和验证接口是否正常。

使用方法

1.在左侧导航栏点击”聊天”菜单

2.在顶部选择要测试的模型(如下拉菜单中选择deepseek-v4-pro)

3.在输入框中输入消息内容

4.按回车或点击发送按钮

5.AI将实时流式输出回复内容

6.可以在对话中随时切换模型进行对比测试

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图25

四、API接口调用详解

1.基础信息

  • BaseURL:https://api.hcnsec.cn
  • 鉴权方式:所有接口均使用标准OpenAI鉴权方式,在请求头中携带Authorization:Bearer<YOUR_API_KEY>。
  • 兼容性说明:本平台严格遵循OpenAI官方标准API规范,不提供任何自定义扩展接口(如/v1/responses、/v1/messages等)。所有请求必须使用下文列出的标准路径。

2.核心接口列表

接口名称 路径 方法 说明
对话补全 /v1/chat/completions POST 核心对话交互接口,支持流式/非流式
嵌入生成 /v1/embeddings POST 文本向量化,用于语义搜索/RAG
图像生成 /v1/images/generations POST 根据提示词生成图片
图像变体 /v1/images/variations POST 基于原图生成变体
语音合成 /v1/audio/speech POST 文本转语音(TTS)
语音转写 /v1/audio/transcriptions POST 语音转文本(STT)
模型列表 /v1/models GET 获取平台可用模型列表

3.接口详细说明

3.1对话补全接口(/v1/chat/completions)

这是最核心的接口,用于与大语言模型进行对话。

请求示例(Python):

fromopenaiimportOpenAI

client=OpenAI(
api_key=”sk-your-api-key”,
base_url=”https://api.hcnsec.cn/v1″
)

response=client.chat.completions.create(
model=”deepseek-v4-pro”,#请使用平台模型广场中的准确ID
messages=[
{“role”:”system”,”content”:”你是一个有帮助的助手”},
{“role”:”user”,”content”:”你好”}
],
stream=False
)
print(response.choices[0].message.content)

3.2嵌入接口(/v1/embeddings)

将文本转换为向量表示。

请求示例(Python):

response=client.embeddings.create(
model=”text-embedding-3-small”,
input=”这是一段需要向量化的文本”
)
print(response.data[0].embedding)

3.3图像生成接口(/v1/images/generations)

根据文字描述生成图片。

请求示例(Python):

response=client.images.generate(
model=”dall-e-3″,
prompt=”一只穿着宇航服的猫咪在月球上漫步”,
n=1,
size=”1024×1024″
)
print(response.data[0].url)

3.4图像变体接口(/v1/images/variations)

基于已有图片生成风格相似但内容有变化的新图片。

⚠️注意:接口路径为/v1/images/variations,SDK方法名为create_variation。

请求示例(Python):

response=client.images.create_variation(
model=”dall-e-2″,
image=open(“original.png”,”rb”),
n=2,
size=”1024×1024″
)
print(response.data[0].url)

3.5语音合成接口(/v1/audio/speech)

将文本转换为语音音频。

请求示例(Python):

frompathlibimportPath

response=client.audio.speech.create(
model=”tts-1″,
voice=”alloy”,
input=”欢迎使用新疆幻城网安科技公益大模型”
)
response.stream_to_file(“output.mp3”)

3.6模型列表接口(/v1/models)

获取平台当前支持的所有模型信息。

⚠️注意:路径必须为/v1/models,禁止使用/v1beta/models。

请求示例(Python):

models=client.models.list()
formodelinmodels.data:
print(model.id)

4.重要注意事项

  1. BaseURL拼写:务必确保使用https://api.hcnsec.cn,域名中间是点号.而非逗号,。
  2. 模型ID:调用模型时,model参数必须与平台控制台“模型广场”中显示的ID完全一致(例如deepseek-ai/DeepSeek-R1-0528),不可自行拼写或使用非平台支持的ID。
  3. 接口路径:本平台仅支持OpenAI标准路径。调用/v1/responses、/v1/messages等非标准路径将返回404NotFound错误。
  4. 鉴权方式:所有接口统一使用Authorization:Bearer<key>,无需Anthropic原生的x-api-key头部。
  5. 公益性质:平台提供公益免费额度,具体限制请以控制台最新公告为准。

五、支持的模型与供应商

平台目前已接入30余家大模型供应商,以下为主要支持的模型系列:

模型系列 包含具体模型(示例) 说明
通义千问Qwen Qwen3-235B、Qwen3-Coder、Qwen3.5-397B、Qwen3.5-plus、Qwen3.6-35B、Qwen3.6-plus 阿里巴巴达摩院
智谱清言GLM glm-4.7-flash、glm-5、glm-5.1 北京智谱华章
深度求索DeepSeek deepseek-v3.2、deepseek-v4-flash、deepseek-v4-pro 北京深度求索
月之暗面Kimi kimi-k2.5、Kimi-K2.6 北京月之暗面
快手Kat kat-coder-pro-v2 北京快手科技
MiniMax mimo-v2-omni、mimo-v2-pro、mimo-v2.5、mimo-v2.5-pro、minimax-m2.5 上海稀宇科技
百度文心ERNIE ernie-4.5-turbo-20260402 北京百度网讯
讯飞星火Spark SparkX2、Spark-X2-Flash 科大讯飞
阶跃星辰Step step-3.5-flash、step-3.7-flash、step-image-edit 上海阶跃星辰
商汤日日新SenseNova sensenova-6.7-flash-lite、sensenova-u1-fast 上海商汤智能
智能路由 aisp-auto-route、astron-code-latest、auto 本平台调度

一、智能路由

模型名称 模型ID 说明
自动选择 auto 智能路由,自动选择最优模型

二、DeepSeek系列

模型名称 模型ID 说明
DeepSeek-V4-Flash DeepSeek-V4-Flash DeepSeekV4快速版
DeepSeek-V4-Pro DeepSeek-V4-Pro DeepSeekV4专业版
DeepSeekV4Flash(优化版) xopdeepseekv4flash DeepSeekV4Flash优化版
DeepSeekV4Pro(优化版) xopdeepseekv4pro DeepSeekV4Pro优化版

三、智谱GLM系列

模型名称 模型ID 说明
GLM-4.7 glm-4.7 智谱GLM-4.7
GLM-5.1 glm-5.1 智谱GLM-5.1
GLM-5.2 glm-5.2 智谱GLM-5.2

四、通义千问Qwen系列

模型名称 模型ID 说明
Qwen3.5-397B-A17B Qwen3.5-397B-A17B Qwen3.5397B参数
Qwen3.5Plus qwen3.5-plus Qwen3.5Plus
Qwen3.6-27B Qwen3.6-27B Qwen3.627B参数
Qwen3.6-35B-A3B Qwen3.6-35B-A3B Qwen3.635B参数
Qwen3.6Plus qwen3.6-plus Qwen3.6Plus
Qwen3.7Plus qwen3.7-plus Qwen3.7Plus
Qwen3CoderNextFP8 Qwen3-Coder-Next-FP8 Qwen3Coder编程专用

五、GPT系列(OpenAI)

模型名称 模型ID 说明
GPT-5.3Codex gpt-5.3-codex GPT-5.3Codex编程版
GPT-5.4 gpt-5.4 GPT-5.4
GPT-5.5 gpt-5.5 GPT-5.5
GPTImage2 gpt-image-2 GPT图像生成
Gemini3.1Pro预览版 gemini-3.1-pro-preview Gemini3.1Pro预览版

六、Gemini系列(Google)

模型名称 模型ID 说明
Gemini3.1Pro预览版 gemini-3.1-pro-preview Gemini3.1Pro预览版

七、Kimi系列(月之暗面)

模型名称 模型ID 说明
KimiK2.6 kimi-k2.6 KimiK2.6
KimiK2.7Code kimi-k2.7-code KimiK2.7Code编程版

八、MiniMax系列

模型名称 模型ID 说明
MiniMaxM2.5 MiniMax-M2.5 MiniMaxM2.5
MiniMaxM3 MiniMax-M3 MiniMaxM3

九、讯飞星火Spark系列

模型名称 模型ID 说明
SparkX2Flash Spark-X2-Flash 讯飞星火X2Flash

十、快手Kat系列

模型名称 模型ID 说明
KatCoderProV2 kat-coder-pro-v2 快手KatCoderProV2

十一、阶跃星辰Step系列

模型名称 模型ID 说明
Step3.5Flash step-3.5-flash Step3.5Flash
Step3.5Flash2603 step-3.5-flash-2603 Step3.5Flash(2603版)
Step3.7Flash step-3.7-flash Step3.7Flash
StepRouterV1 step-router-v1 StepRouterV1路由
StepImageEdit2 step-image-edit-2 Step图像编辑V2

十二、StepAudio语音系列

模型名称 模型ID 说明
StepAudio2.5ASR stepaudio-2.5-asr StepAudio语音识别
StepAudio2.5Chat stepaudio-2.5-chat StepAudio语音对话
StepAudio2.5Realtime stepaudio-2.5-realtime StepAudio实时语音
StepAudio2.5TTS stepaudio-2.5-tts StepAudio语音合成

平台当前共支持35个AI大模型,涵盖:

  • 🧠对话/推理模型:DeepSeek、GLM、Qwen、GPT、Gemini、Kimi、MiniMax、Spark、Step
  • 💻编程专用模型:Qwen3Coder、KimiK2.7Code、KatCoderPro、GPT-5.3Codex
  • 🖼️图像生成模型:GPTImage2、StepImageEdit2
  • 🎙️语音模型:StepAudio系列(ASR、TTS、实时语音

你也可以自己通过powershell来看支持那些模型

Invoke-WebRequest-Uri”https://api.hcnsec.cn/v1beta/models”-Headers@{“Authorization”=”Bearer你的APIKey”}-UseBasicParsing

Python也可以:

fromopenaiimportOpenAI

client=OpenAI(

api_key=”你的APIKey”,

base_url=”https://api.hcnsec.cn/v1″

)

models=client.models.list()

formodelinmodels.data:

print(model.id)

常见使用场景示例

从API平台直接配置教程:

从新疆幻城网安科技公益大模型api的平台中可以直接配置,跳转到CC Swich,教程如下:

第一步:找到令牌管理,配置好密钥后点击“聊天”旁的倒三角,跳出弹窗后,点击CC Swich。

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图26

第二步:选择要使用的工具,进行配置。

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图27

第三步:选择模型

Claude:选择自己的喜好模型后点击“打开CC Swich”

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图28

Codex/Gemini:选择自己的喜好模型后点击“打开CC Swich”

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图29

第四步:这里选择打开,然后会自动跳转到CC Swich

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图30

跳转后选择导入

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图31

成功后会显示成功导入

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图32

路由:当需要使用codex/Gemini时,需要打开路由,只需要按下图配置打开即可。

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图33

6.1在Claudecode中使用

通过CC Swich更换模型即可

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图34

6.2在codex中使用

通过CC Swich调用模型

零门槛接入大模型:幻城网安公益API平台从注册到实战全攻略插图35

6.3在Python代码中使用

使用OpenAIPythonSDK调用:

fromopenaiimportOpenAI

#初始化客户端
client=OpenAI(
api_key=”sk-your-api-key”,
base_url=”https://api.hcnsec.cn/v1″
)

#对话补全
response=client.chat.completions.create(
model=”deepseek-v3.2″,
messages=[
{“role”:”system”,”content”:”你是一个专业的编程助手”},
{“role”:”user”,”content”:”用Python写一个快速排序算法”}
],
temperature=0.7,
stream=True
)

forchunkinresponse:
ifchunk.choices[0].delta.content:
print(chunk.choices[0].delta.content,end=””)

6.4在Node.js代码中使用

使用OpenAINode.jsSDK调用:

importOpenAIfrom”openai”;

constclient=newOpenAI({
apiKey:”sk-your-api-key”,
baseURL:”https://api.hcnsec.cn/v1″,
});

asyncfunctionmain(){
constresponse=awaitclient.chat.completions.create({
model:”deepseek-v3.2″,
messages:[
{role:”user”,content:”用JavaScript写一个冒泡排序算法”}
],
});

console.log(response.choices[0].message.content);
}

main();

七、常见问题与故障排查

Q:调用API返回401Unauthorized错误

A:请检查以下几点:

  1. APIKey是否正确填写;
  2. APIKey是否已过期;
  3. APIKey是否已被禁用或删除;
  4. AuthorizationHeader格式是否为”Bearersk-xxx”。

Q:调用API返回429TooManyRequests错误

A:表示请求频率超过限制。请:

  1. 降低请求频率;
  2. 检查是否有并发请求过多;
  3. 如需更高并发额度,请联系管理员。

Q:调用API返回402PaymentRequired或额度不足错误

A:表示账户余额不足。请前往控制台充值页面进行充值,或使用兑换码增加额度。

Q:模型返回的内容不完整或被截断

A:可能原因:

  1. max_tokens设置过小,请增大该参数值;
  2. 输入prompt过长导致输出空间不足,请减少输入长度或增大max_tokens。

Q:流式输出中断或无法正常接收

A:请检查:

  1. 网络连接是否稳定;
  2. 是否正确处理SSE数据流;
  3. 是否设置了合理的超时时间。如问题持续,可在日志模块查看详细错误信息。

Q:如何查看API调用的详细日志?

A:登录控制台,进入”日志”模块,可以查看每次API调用的详细信息,包括请求时间、模型、Token用量、消耗额度和状态等。支持按多种条件筛选。

Q:如何选择合适的模型?

A:建议:

  1. 日常对话和通用任务:deepseek-v3.2、qwen3-235b性价比高;
  2. 编程任务:deepseek-v3.2、qwen3-coder;
  3. 需要高质量输出:选择参数量更大的模型;
  4. 使用智能路由模型(auto),让平台自动选择最优模型。

Q:APIKey创建后能再次查看完整密钥吗?

A:不能。APIKey仅在创建时显示一次完整密钥,之后只能看到部分隐藏的Key(如sk-****xxxx)。请务必在创建时立即复制保存。如遗忘密钥,请删除旧密钥并重新创建。

Q:为什么有些模型无法调用?

A:可能原因:

  1. 令牌设置了模型白名单,限制只能访问特定模型;
  2. 用户分组未授权该模型;
  3. 该模型的渠道暂时不可用。请检查令牌设置或联系管理员。

Q:如何实现多个APIKey的负载均衡?

A:在渠道管理中添加同一个供应商的多个渠道(每个渠道配置不同的APIKey),设置不同的权重值,平台会按权重自动分配请求。

八、合规与安全说明

8.1合规运营

  • 本平台所有模型均为与各模型厂商官方签订正式企业套餐,通过官方授权的企业级API接口进行合法中转服务
  • 本平台从未采用任何逆向工程、破解、爬虫、模拟登录等技术手段非法获取模型能力
  • 所有国内大模型均已通过国家互联网信息办公室生成式人工智能服务备案
  • 平台严格遵守《刑法》《网络安全法》《数据安全法》《生成式人工智能服务管理暂行办法》等相关法律法规

8.2企业资质

企业名称:新疆幻城网安科技有限责任公司

统一社会信用代码:91650106MAEG1B0K6W

ICP备案:新ICP备2026002340号-1

公安网安备案:兵公网安备66120102000167号

8.3用户法律义务

用户在使用本平台服务时,必须严格遵守以下法律法规:

  • 遵守《刑法》相关规定,不得利用服务实施违法犯罪活动
  • 遵守《网络安全法》,不得从事危害网络安全的活动
  • 遵守《数据安全法》,不得非法获取、出售或向他人提供数据
  • 遵守《生成式人工智能服务管理暂行办法》,不得利用生成内容从事违法活动
  • 遵守《个人信息保护法》,不得非法收集、使用他人个人信息
  • 禁止恶意滥用,不得对平台进行攻击、破解、逆向工程
  • 违法责任自负,用户因违反规定产生的法律责任由用户自行承担

8.4联系方式

官方邮箱:yangyuqi@xjhcit.cn

官方QQ群:943554225

© 版权声明
THE END
喜欢就亲吻一下吧!官方qq群号:253193620
分享
评论 抢沙发
头像
评论一下幻城的文章吧
提交
头像

昵称

取消
昵称代码图片快捷回复
    blank

    暂无评论内容