SixAM 智能云 ● API 文档
OpenAI 兼容的大模型接口。一把 key、一个地址,对话 / 向量 / 视觉 / 生图 / 语音 / 视频都在这里,按用量结算。
快速开始
地址 https://api.6amtech.cn/v1,鉴权 Authorization: Bearer sk-sixam-…。任何 OpenAI SDK 只需改 base_url 和 api_key:
curl https://api.6amtech.cn/v1/chat/completions \
-H "Authorization: Bearer $SIXAM_API_KEY" -H "Content-Type: application/json" \
-d '{"model":"doubao-seed-2-1-pro","messages":[{"role":"user","content":"你好"}]}'# Python
from openai import OpenAI
client = OpenAI(base_url="https://api.6amtech.cn/v1", api_key="sk-sixam-…")
r = client.chat.completions.create(model="doubao-seed-2-1-pro", messages=[{"role":"user","content":"你好"}], stream=True)
for chunk in r: print(chunk.choices[0].delta.content or "", end="")// Node
import OpenAI from "openai"
const client = new OpenAI({ baseURL: "https://api.6amtech.cn/v1", apiKey: process.env.SIXAM_API_KEY })
const r = await client.chat.completions.create({ model: "doubao-seed-2-1-pro", messages: [{ role: "user", content: "你好" }] })模型
GET /v1/models 返回当前可用目录,每项带 type(chat / embedding / image / asr / tts / video)和 status(ok 或 degraded)。degraded 表示这个模型的所有上游线路在最近一次自动探活中都不可用,建议暂时换模型。目录与价格以管理方提供的报价单为准,这里只说规则。
- 对话模型(type=chat)支持流式、工具调用、
image_url视觉输入、thinking深度思考等参数,请求体原样透传给上游,OpenAI 格式即可。 - 向量模型(type=embedding)走标准
/v1/embeddings;上游接口形状的差异由平台吸收,你不需要关心。 - 生图 / 语音 / 视频见下方接口表。
接口
| 接口 | 说明 | 计量 |
|---|---|---|
POST /chat/completions | 对话补全。stream:true 走 SSE;想在流末尾拿到 usage 加 stream_options.include_usage:true | token(输入 / 缓存命中 / 输出) |
POST /embeddings | 向量化。input 可为字符串或数组 | 输入 token |
POST /images/generations | 文生图。返回 data[].url;size 默认按模型要求(部分模型有最小分辨率) | 按张,或按百万像素(按分辨率收费的模型,如 Seedream;报价单会注明) |
POST /audio/transcriptions | 语音识别,multipart 上传 file(≤100MB) | 按音频时长(分钟) |
POST /audio/speech | 语音合成,返回二进制音频流 | 按输入字符(万字符) |
POST /video/generationsGET /video/generations/{id} | 视频生成为异步任务:创建返回 id(vt_…),轮询直到 status 为 succeeded / failed。费用在任务成功时结算一次,轮询不重复计费 | 按模型报价(token) |
GET /account | 余额、今日消费、日预算、按近 7 天用量估算的 days_left | — |
GET /account/usage?days=30 | 按日 × 模型的用量与费用(最多 92 天) | — |
GET /account/bill?month=2026-08&format=csv | 月对账单(JSON 或 CSV,期初 / 充值 / 消费 / 期末,逐日逐模型) | — |
GET /account/ledger?limit=50&offset=0 | 资金台账逐笔(充值 / 消费 / 调整,含变动后余额) | — |
幂等重试:Idempotency-Key
网络超时后重试可能造成重复扣费。对 /chat/completions、/embeddings、/images/generations 带上请求头 Idempotency-Key: <你生成的唯一串,≤128 字符>:24 小时内同一 key 的重复请求不再调用模型、不再扣费,直接返回首次的响应(非流式、≤256KB;响应头带 x-sixam-idempotent-replay: true)。流式请求只防重复扣费,不重放内容(返回 409)。首次请求若因上游不可达/限流失败,key 会被释放,可直接重试。
每个成功响应都带 x-sixam-request-id;有疑问时把它发给我们,能精确定位到这一笔(含上游请求 id)。请求体上限:JSON 8MB,语音上传 100MB。
错误与限流
错误体是 OpenAI 格式 {"error":{"message","type","code"}}。需要处理的 code:
| HTTP | code | 含义 | 怎么办 |
|---|---|---|---|
| 401 | invalid_api_key | key 错误 / 已停用 | 检查 key |
| 401 | key_expired | key 已到期 | 换用新 key |
| 403 | ip_denied / model_not_allowed | 这把 key 限定了来源 IP / 可用模型 | 换用相应 key,或联系我们放宽 |
| 409 | idempotency_in_progress / idempotency_replayed | 同一 Idempotency-Key 的首次请求仍在进行 / 首次是流式(不重放内容) | 等首次完成;流式请求换新 key |
| 402 | insufficient_quota | 余额为 0 | 充值;/account 可提前看 days_left,也可配置低余额群提醒 |
| 404 | model_not_found | 模型不在目录或类型不符 | 看 /models |
| 429 | rpm_limit | 这把 key 每分钟请求数超限 | 看 Retry-After(秒)再重试:RPM 到窗口结束;日预算到东八区零点;并发 1 秒;上游流控几秒。不要不看 Retry-After 盲目重试 |
| 429 | daily_budget | 账户当日预算已用完 | |
| 429 | model_daily_budget | 该模型的当日封顶已用完(其它模型不受影响) | |
| 429 | concurrency | 账户并发请求数超限 | |
| 429 | upstream_throttled | 上游流控,平台已退避重试仍失败 | |
| 400 | body_too_large | 请求体超限 | 拆分 / 压缩输入 |
| 4xx | (上游原样) | 参数错误等语义性错误,原样返回上游错误体 | 按上游提示改参数 |
| 502 | upstream_error | 上游不可达 / 5xx,已尝试备用线路 | 稍后重试;持续出现请联系我们 |
流式请求一旦开始回流(已发出第一个 chunk),中途上游故障会以流中断表现,不会再返回错误 JSON;这一笔按实际收到的 usage 计费,没有 usage 则不计费。
计费与账单
- 预付费:充值到账户,每次调用成功后按你账户的生效价逐笔扣减,失败(4xx/5xx)不扣费。生效价 = 专属价 > 目录价 × 账户折扣 > 目录价。
- token 计费三档:输入 / 缓存命中的输入(上游前缀缓存命中部分按缓存价)/ 输出;深度思考(reasoning)token 计入输出。以上游返回的 usage 为准。
- 按单位计费:生图按张或按百万像素(输出像素数 × 单价 / 10⁶,向上取整)、语音识别按分钟(秒 × 分钟价 / 60 向上取整)、语音合成按万字符。
- 每模型日封顶(可选):对某个模型单独设当日上限,烧完只有这个模型 429,其它模型不受影响 —— 适合把视频/生图这类贵的能力圈起来。
- 金额精度:内部以微元(1 元 = 1,000,000 微元)整数记账,每笔向上取整到微元,不会出现小数漂移;台账每一行都带变动后余额,
/account/ledger与/account/bill可逐笔对平。 - 闸门:每把 key 有每分钟请求数上限,账户有并发上限与可选的日预算封顶(防止失控烧钱),都可按需调整。
- 月账单:每月 1 日自动生成上月账单;配置了群机器人 webhook 的账户会收到通知,也可随时用
/account/bill自取 CSV。
数据与隐私
- 平台不存储你的提示词、对话内容、上传的音频、生成的结果。转发完成即丢弃,日志只记接口路径与状态码。
- 每笔调用留存的只有计量元数据:时间、模型、token / 张数 / 时长、费用、耗时、上游请求 id、错误码。这是账单与排障的依据。
- 你的 key 在平台只保存哈希,明文仅在签发时出现一次;丢失请重新签发并停用旧 key。
- 上游为国内主流模型服务商(火山方舟等),数据不出境。
SixAM Tech · 服务状态