最近调用
仅展示最近 8 条计费请求,轮询查询不计入。
| 模型 | 接口 | 状态 | 消费 | 耗时 | 时间 |
|---|---|---|---|---|---|
| 加载中... | |||||
API 密钥
密钥用于调用 /v1 接口,完整密钥仅在创建时展示一次。
| 名称 | 密钥 | 状态 | 创建时间 | 操作 |
|---|---|---|---|---|
| 加载中... | ||||
| 暂无密钥,点击右上角创建 | ||||
支付宝在线充值
生成支付宝付款二维码,支付成功后自动到账;请以页面订单状态为准。
付款后页面会自动刷新订单状态,到账后余额同步更新。
兑换码充值
输入兑换码,余额将即时到账。
充值记录
只显示充值订单和状态;支付成功后会自动变为已到账。
| 订单 | 金额 | 到账积分 | 状态 | 时间 |
|---|---|---|---|---|
| 加载中... | ||||
| 暂无充值记录 | ||||
流水日志
| 类型 | 金额 | 余额 | 备注 | 时间 |
|---|---|---|---|---|
| 加载中... | ||||
| 暂无交易记录 | ||||
请求日志
| 模型 | 接口 | 结果 | 输入/输出 | 数量 | 消费 | 耗时 | 时间 |
|---|---|---|---|---|---|---|---|
| 加载中... | |||||||
| 暂无日志 | |||||||
接入文档
Mai-Token 中转站兼容 OpenAI 接口规范,可直接替换 base_url 与 api_key 使用。
AI 友好文档 · 一键给 AI 助手
把下面这个 URL 发给 ChatGPT / Claude / Cursor 等 AI 助手,它就能完整理解 Mai-Token 的所有模型、调用方式、计费规则 —— 模型清单和价格实时生成,永不过期。
https://mai-token.com/llms.txt
基础信息
https://mai-token.com
Authorization: Bearer <API_KEY>
API Key 在「API 密钥」页面创建。计费单位为积分(credits),1 积分 = 1e6 micro。
接口总览
POST /v1/chat/completions — 同步对话/视频生成,阻塞返回POST /v1/videos — 异步建任务GET /v1/videos/:id — 查询任务(轮询不计费)GET /v1/files/:id — 视频直链下载(无需鉴权)GET /v1/models — 列出已开通模型已开通模型
| 模型 | 类型 | 计费 |
|---|---|---|
| 加载中... | ||
|
||
计费说明
- 按次计费(per_call):每次请求固定扣费 price_call。
- 按 Token 计费(per_token):输入按 price_in、输出按 price_out 分别计费。
- 按时长计费(per_second):视频按生成秒数 × price_second 计费。
- 采用先扣费策略,请求失败或上游错误自动退款。
- 异步任务轮询不计费:GET /v1/videos/:id 仅用于查询状态,不消耗积分。
- 余额不足时请求将被拒绝(HTTP 402),请通过兑换码充值。
常见错误码
| HTTP | code | 含义 |
|---|---|---|
| 401 | missing_api_key / invalid_api_key | 未提供 / 无效的 API Key |
| 402 | insufficient_balance | 余额不足,请充值 |
| 403 | user_disabled / key_disabled | 账号或密钥被禁用 |
| 404 | model_not_found / task_not_found | 模型或任务不存在 |
| 429 | rate_limit_exceeded | 上游限流,稍后重试 |
| 502 | upstream_error | 上游错误(已自动退款) |
Seedance 2.0 视频
异步视频生成 resolution 自动匹配计费Seedance 2.0 只需要选择满血版或 Fast 版两个模型。调用时传 resolution,系统会自动映射到 480p / 720p / 1080p 上游模型,并按对应分辨率秒价扣费。
模型与计费
| 模型 ID | 版本 | 分辨率 | 计费 |
|---|---|---|---|
|
由请求参数 resolution 决定 |
请求参数
| 字段 | 说明 |
|---|---|
| model | seedance-2.0 或 seedance-fast-2.0 |
| mode | text_to_video / image_to_video / first_last_frame / multi_ref;也兼容 text2video / img2video |
| prompt | 视频提示词 |
| duration | 4-15 秒,默认 5 秒 |
| ratio | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16,默认 16:9 |
| resolution | 480p / 720p / 1080p。系统按此字段自动选择上游模型并自动匹配扣费;不传默认 720p。 |
| image_urls | 参考图 URL 数组。真人图建议先走供应商加白;非真人图可直接传公网 URL。 |
参考图与素材库
Seedance 的生成入口统一使用 image_urls 传参考素材。非真人素材可以直接传公网 HTTPS URL;包含真人肖像、真人角色复用、真人身份一致性的素材,建议先走真人加白库拿到 asset:// 后再生成。虚拟角色、商品、场景、风格参考可以放入虚拟素材库统一管理。
- 适合非真人图、商品图、场景图、风格图。
- 传入公网可访问的 HTTPS 图片地址。
- 无需提前入库,直接放到
image_urls。
- 适合真人头像、真人角色、需要稳定复用的人物。
- 先提交
/realperson,轮询到Active。 - 使用返回的
asset://...作为参考图。
- 适合虚拟角色、产品、场景、道具、品牌资产。
- 先建
asset-groups,再用/assets注册素材。 - 素材
Active后用asset://officialId引用。
| 能力 | 上游路径 | 流程 | 生成时怎么传 |
|---|---|---|---|
| 真人加白 | POST /realperson GET /realperson/{officialId} | 提交真人图片 URL 和名称,等待状态变为 Active,取返回的 assetRef。 | "image_urls": ["asset://..."] |
| 虚拟库分组 | POST /asset-groups GET /asset-groups | 创建素材分组,例如角色库、商品库、场景库;region 可用 cn / intl。 | 分组本身不直接参与生成,用来管理素材。 |
| 虚拟素材 | POST /assets GET /assets/{officialId} | 把素材 URL 注册到分组,轮询到 Active 后复用 officialId。 | "image_urls": ["asset://officialId"] |
示例
轮询与退款
- 创建任务成功后保存
task_id,每 10-30 秒轮询一次。 - 返回
SUCCESS时读取result_url,该链接已转存到本站 CDN。 - 轮询不计费;上游失败或任务失败会自动退款。
- Fast 通常约 3-5 分钟出片,满血版通常约 5-10 分钟出片。
Grok Imagine Video 1.5
视频生成 · 同步grok-imagine-video-1.5-preview
图生视频:每次请求必须提供一张参考图(base64 内嵌或公网图片 URL)。
采用同步方式:阻塞约 30–60 秒后直接返回视频直链,单次只扣一次费。建议客户端总超时 ≥ 900 秒。
请求示例 · POST /v1/chat/completions
video_config 字段
| 字段 | 可选值 | 说明 |
|---|---|---|
| video_length | 6 · 10 | 视频时长(秒),仅支持 6 或 10 |
| aspect_ratio | 16:9 · 9:16 · 1:1 · 3:2 · 2:3 | 画面比例,横屏 16:9 / 竖屏 9:16 |
| resolution | HD · SD | 清晰度,HD≈720p,SD≈480p |
| preset | normal | 风格预设,建议传 normal |
返回与下载
- 成功返回标准 chat.completion,视频直链在
choices[0].message.content中。 - 直链域名为
cdn.xs-token.com或api.xs-token.com/v1/files/<id>,内容为video/mp4,直接 GET 即可下载,无需带鉴权头。 - content 个别情况下可能被包成 markdown,建议用正则
https?://[^\s"'`]+兜底提取。
MGDB 视频
视频生成 · 异步 文生 / 图生mgdb-video
使用异步路径:先 POST 建任务,再每 5 秒轮询 GET 查询状态,SUCCESS 时拿到视频直链(已自动转存到本站 CDN)。整段约 3–5 分钟。
支持文生视频与图生视频(参考图最多 9 张)。按次计费:每条 2.2 积分,与时长无关。
示例
同步调用:单次请求阻塞 20–60 秒返回图片直链。
接口路径:POST /v1/chat/completions(不是 /v1/images/generations)— 走 OpenAI 多模态对话格式。
返回的 content 形如 ,中转已自动把上游 base64 落到我们的 CDN,客户端直接 GET 这个 URL 拿 PNG,无需自己解码。
三种用法
- 文生图:
messages[0].content直接传一段提示词字符串。 - 图生图 / 编辑:
messages[0].content传数组,把参考图作为image_url项放最前面,文字描述放后面。 - 多图融合:在
content数组里塞多张image_url,模型会综合参考。
示例
返回与下载
- 成功返回标准 chat.completion,
choices[0].message.content是 markdown 字符串:。 - URL 是
https://cdn.xs-token.com/images/<id>.png,直接 GET 即可下载,无需鉴权。 - 建议用正则
https?://[^\s)\"'<>]+兜底提取 URL。 - 客户端总超时建议 ≥ 120 秒。
注意事项
- 本模型只走
/v1/chat/completions。试图调/v1/images/generations会被上游拒绝only imagen models are supported。 - 提示词建议明确写"生成一张图"或英文 "Generate an image",模型才会输出图像而不是文字描述。
- 参考图支持
data:image/jpeg;base64,...data URI 或公网 URL,最多 4 张。 - 计费为 per_call 按次计费,与输出图片大小无关;轮询不需要(同步返回)。
图床上传
同步 multipart 免费POST /v1/images/upload
用你自己的 sk-xs-... Key 直传一张图片到我们的 R2,返回 永久可用的 CDN 公开 URL。
典型用途:把本地图片转成 公网 URL,给 MGDB 视频的 images / reference_images 或 Gemini 的 image_url 用。
规则
| 项 | 说明 |
|---|---|
| Content-Type | multipart/form-data |
| 字段名 | file(推荐) / image / image[] 任意一个 |
| 单文件大小 | ≤ 2 MB |
| 支持格式 | JPG / PNG / WEBP / GIF |
| 数量限制 | 不限张数,免费使用 |
| 鉴权 | Authorization: Bearer sk-xs-... |
| 存储位置 | cdn.xs-token.com/uploads/<uid>/<ts>_<rand>.<ext> · 永久有效 |
示例
返回字段
{
"url": "https://cdn.xs-token.com/uploads/3/1780640570_27ad0b68a5c591fe.jpg",
"key": "uploads/3/1780640570_27ad0b68a5c591fe.jpg",
"size": 40496,
"mime": "image/jpeg",
"filename": "seed.jpg"
}
- url — 公开 CDN URL,直接可访问(无需鉴权)
- key — R2 对象 key,以
uploads/<你的 user_id>/开头 - size / mime / filename — 元信息
错误码
401 missing_api_key / invalid_api_key— 未带或无效的 Key400 missing_file— multipart 字段名不对(请用file)400 upload_too_large— 超过 2 MB400 invalid_format— 不是 JPG/PNG/WEBP/GIF503 storage_unavailable— R2 暂不可用(极少见)