ICESPAN 使用文档

从注册到跑通第一个请求,以及计费规则、模型差异、数据处理原则和问题上报渠道。

01快速开始

本站完全兼容 OpenAI 接口协议,同时提供 Anthropic 格式端点。绝大多数客户端只需要换掉接口地址和密钥,代码不用动。

三步跑通

  • 注册并充值 —— 在控制台注册,人民币充值。余额按 token 实时扣减,用多少扣多少,不设最低消费。
  • 创建令牌并选号池 —— 在「令牌」页新建一个 Key,同时选定它走哪个号池分组。分组决定价格和可用模型,建好后也能改。
  • 替换接口地址 —— 把客户端里的 base_url 指向下方地址,密钥填刚建的令牌。

OpenAI 格式

https://api.icespan.com/v1

Anthropic 格式

https://api.icespan.com

验证是否接通

curl https://api.icespan.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"你好"}]}'
返回 200 且带 usage 字段就说明通了。如果返回 401,检查令牌是否完整复制(含 sk- 前缀);返回「无可用渠道」说明该模型不在你令牌所选的分组里。

02客户端接入

Codex CLI / ChatGPT 桌面客户端

编辑 ~/.codex/config.toml(Windows 在 C:\Users\用户名\.codex\config.toml),把下面内容覆盖进去。建议先备份原文件。

model_provider = "icespan"
model = "gpt-6-astra"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.icespan]
name = "icespan"
base_url = "https://api.icespan.com/v1"
wire_api = "responses"
requires_openai_auth = true

保存后启动客户端,在登录界面选择「其他方式登录」→「API Key 登录」,填入本站令牌即可。

模型列表不刷新时:客户端会缓存模型清单。完全退出后删除 ~/.codex/models_cache.json(Windows 为 C:\Users\用户名\.codex\models_cache.json)再启动。只删这一个文件,不要删整个 .codex 目录,否则配置和历史会话会一起没。

Claude Code

本站提供 Anthropic 格式端点,Claude Code 可以直接接,不需要改模型名或装转换层。设三个环境变量即可:

export ANTHROPIC_BASE_URL="https://api.icespan.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
export ANTHROPIC_MODEL="gpt-6-astra"

写进 ~/.zshrc 或 ~/.bashrc 可以持久生效。之后照常运行 claude,底层走的就是本站的模型。

CCSwitch

  • 点右上角加号进入「添加供应商」
  • 类型选 Codex 供应商,配置方式选 自定义
  • 名称随意填,接口地址填 https://api.icespan.com/v1,API Key 填本站令牌

通用 OpenAI 兼容客户端

Cherry Studio、LobeChat、NextChat、DeepChat、OpenCat、AionUI 等,都在设置里找「OpenAI 兼容 / 自定义服务商」,把接口地址填 https://api.icespan.com/v1、密钥填令牌即可。控制台首页也提供了部分客户端的一键导入链接。

03模型说明

下面按用途列出全部模型。同一个模型在不同号池里价格不一样,但能力完全相同。

标准系列

模型定位适用场景
gpt-6-astra旗舰推理复杂推理、长上下文、需要最强能力的任务
gpt-5.6-sol高阶通用日常主力,能力与成本平衡
gpt-5.5上一代旗舰行为稳定,不想跟着新版本改提示词时用它
gpt-5.6-terra日常通用常规问答、代码补全,性价比高
gpt-5.6-luna轻量快速批量、简单任务,单价最低

特色系列

模型定位说明
codex-auto-review代码审查专门读代码改动挑问题,不适合当通用对话模型用
gpt-5.3-codex-sparkCodex 专用容量有限,需联系客服开通

图像生成系列

模型计费规格
gpt-image-1.5按张 ¥0.10输出 1K,暂不支持 4K
gpt-image-2按张 ¥0.10输出 1K,暂不支持 4K
每次请求出 1 张,n 参数暂不生效;需要多张请多次请求。

号池分组

分组价格包含模型
codex-pro标准价gpt-6-astra、gpt-5.6-sol、gpt-5.5、gpt-5.6-terra、gpt-5.6-luna、codex-auto-review
codex-spark标准价gpt-5.3-codex-spark(需开通)
codex-image×1.0gpt-image-1.5、gpt-image-2
关于「满血」:我们不动模型:不改写你的系统提示、不裁剪上下文、不会偷偷换成更小更便宜的模型。至于模型本身表现如何,那由上游决定,我们不打包票。

04计费说明

按 token 实时计费,人民币结算。一次调用的费用由三部分构成:

# 单价（元 / 百万 token）
输入单价 = 2 × 模型倍率 × 分组倍率
输出单价 = 输入单价 × 补全倍率
缓存读取 = 输入单价 × 0.1
缓存写入 = 输入单价 × 1.25
  • 模型倍率 —— 每个模型固定,按官方标准价折算,官方越贵倍率越高。gpt-6-astra 例外:它占用的上游账号额度远高于其他模型,模型倍率在官方价折算的基础上再 ×1.5。
  • 分组倍率 —— 由令牌所选号池决定,见上一节。
  • 补全倍率 —— 输出比输入贵。多数模型为 6 倍,gpt-6-astra 为 5 倍。
输出才是大头。输出单价是输入的 5–6 倍,所以控制回复长度比控制提示词长度更省钱。命中缓存的输入只按一折计费,重复前缀的长对话会明显便宜。不过上下文越滚越长也有代价 —— 见下面的长上下文分段。

长上下文分段

上面的单价是标准档。当单次请求的输入超过 272,000 个 token时, 这次调用换成长上下文档计价:

项目标准档 (输入 ≤ 272K)长上下文档 (输入 > 272K)
输入基准单价× 2
输出基准单价 × 补全倍率× 1.5
缓存读取输入 × 0.1× 2
是整单换价,不是只对超出部分加价。输入 273,000 token 的请求, 这 273,000 个 token 全部按长上下文档的单价算,不是「272K 按标准价 + 1K 按高价」。 所以把上下文压在 27.2 万以内,和压到 27.3 万,费用差的是整整一倍而不是一点点。

判定依据是输入长度(含命中缓存的部分),与输出长度无关。 常见的规避办法:开新会话而不是一路追加、先检索再提问、长文档先摘要再喂给模型。

gpt-5.3-codex-spark 的上下文上限是 128K,到不了这个门槛,不分档;生图模型按张计费,同样不分档。

接口开销

每次请求都会带上一段固定的系统提示词,大约 300 个 token。上游照实收费,所以这部分也会算进你的账单。发大量短请求时它占比偏高,能合并就尽量合并。

查询用量

控制台「日志」页按请求列出模型、输入输出 token 数和扣费明细,可按时间和令牌筛选,支持导出。

05常见问题

返回「无可用渠道」怎么办?

说明你请求的模型不在当前令牌所选的分组里。到控制台「令牌」页确认分组,或换用该分组内的模型。gpt-5.3-codex-spark 属于单独分组,需要联系客服开通。

提示 401 未授权

多数是令牌没复制完整。令牌以 sk- 开头,请确认前后没有空格或换行。也请确认令牌未被禁用、未过期、额度未用尽。

支持流式输出吗?

支持。在请求里加 "stream": true 即可,与 OpenAI 官方行为一致,走 SSE。

暂不支持 WebSocket 形式的流式接口(如 Realtime),需要流式请用 SSE。

能用 Claude Code 吗?

可以。本站提供 Anthropic 格式端点,设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 后直接使用,模型名仍填本站的模型 ID。详见「客户端接入」。

额度会过期吗?

已充值额度自最后一次充值或调用之日起 12 个月内有效,期间任何一次充值或调用都会重新起算。连续 12 个月无充值也无调用的账户视为不活跃,我们会提前 15 日邮件通知后清零剩余额度。完整规则见服务条款第 06 节。

令牌可以单独设置额度上限和过期时间,便于分发给团队成员时控制风险。

调用失败会扣费吗?

请求未成功产生输出的不计费。已产生部分输出后中断的,按实际消耗的 token 计费。

有速率限制吗?

有。为保障号池稳定和避免触发上游风控,平台对单位时间内的请求数做了限制。正常使用不会触及;如有批量需求请提前联系客服评估。

06数据安全与合规

平台处理原则

  • 不将你的输入、输出、代码或业务数据用于训练、微调或蒸馏任何模型。
  • 不出售、出租或转让客户数据。
  • 不将客户数据用于广告投放、用户画像或对外宣传案例。
  • 保留计费、审计和异常排查所必需的调用元数据。

第三方模型服务

本站是模型网关,推理由接入的上游供应商完成。为完成一次调用,你的输入内容、调用参数、必要上下文和模型响应会传输至上游供应商。上游的可用模型、限流策略、上下文长度、内容安全策略和数据处理规则由其自行制定,可能随时调整并影响本站服务。

服务区域与可用性

本服务并非在所有国家和地区提供,平台可基于访问来源等因素限制特定地区的访问。实际可用性还取决于你所在地的法律法规、网络环境以及上游供应商和云服务商的限制。请自行确认你的使用场景、数据类型和终端用户所在地允许使用相应的第三方模型服务。

境外模型与数据出境

本站接入的模型部署在境外。调用时,你提交的内容可能被传输至境外或被境外机构访问。

调用前请确认所提交的数据来源合法、已获授权、已按需脱敏,并已完成适用的个人信息保护影响评估、数据出境合规手续或单独同意。无法确认数据性质或授权状态的,请不要提交。

第三方服务商

类型用途可能处理的数据
模型服务商完成推理调用输入、参数、上下文、响应、调用元数据
云服务商托管应用、数据库与网络账户数据、日志、备份
网络与安全服务商防护、加速、异常检测IP、User-Agent、访问日志、安全事件
支付服务商支付、退款与对账订单号、金额、支付状态
邮件服务商验证码与通知邮箱地址、通知内容

日志留存

  • 默认保存调用元数据(时间、模型、token 数、费用、状态码),用于计费、审计和排障。
  • 默认不长期保存完整的请求与响应正文。
  • 因你授权排障或处置安全事件而需要访问完整内容时,限定范围、短期处理并留存审计记录。
  • 平台可基于安全、成本或上游要求,对请求实施速率限制、额度控制和必要拦截。

07安全事件与投诉举报

发现密钥泄露、账号异常、费用异常,或需要举报违规内容与违规使用,请按下列流程处理。

请先采取的措施

  • 立即在控制台禁用或轮换疑似泄露的令牌。
  • 暂停相关的自动化任务和异常调用。
  • 保留证据:请求 ID、调用时间段、订单号、截图、日志和异常样本。
  • 如疑似涉及违法犯罪,请同时通过适用渠道报案。

提交核查材料

  • 发现时间、涉事账号、受影响的令牌范围。
  • 请求 ID 或调用时间段、涉事模型、调用路径。
  • 异常样本、费用异常截图或订单号。
  • 相同数据是否也提供给过其他平台、供应商或第三方。

平台核查范围

我们将在合理必要范围内核查可控范围内的调用日志、访问记录、人工操作记录和上游调用记录,并向你反馈结论。

关于泄露认定:仅凭第三方知悉了相似信息、网络上出现类似内容或单方怀疑,不足以认定为平台泄露。认定需要基于合法、客观、可核验的证据链。

违规内容举报

本站禁止用于生成或传播下列内容:色情低俗、暴力恐怖、仇恨与歧视言论、危害未成年人、未经同意的深度伪造、以及侵犯他人知识产权或人格权的内容。

发现违规使用可通过下方邮箱举报。我们会记录举报内容、处理流程与反馈结果,对确认违规的,将依法依约采取停止生成、限制功能、暂停或终止服务等措施,并保存必要记录。

受理邮箱: support@icespan.com　·　请在标题注明「安全事件」或「违规举报」,我们会优先处理。