下午好
正在加载用量数据...
调用量趋势
近 7 天的 token 消耗与调用次数
最近活动
常用模型
本周调用排名前 5
| 模型 | 供应商 | 调用 | tokens | 花费 |
|---|---|---|---|---|
| 加载中... | ||||
API Keys
用量分析
详细查看你的 API 调用资源消耗、按模型拆解到使用的 Key · 统计周期:近 7 天
调用量趋势
按模型拆解
tokens 消耗占比
按 Key 拆解
调用次数占比
收藏店铺
查看已收藏店铺,以及你在每家店铺产生的 token 与费用
店铺消费明细
按收藏店铺聚合你的调用次数、tokens 和费用
| 店铺 | 本月 tokens | 本月花费 | 累计 tokens | 累计花费 | 最近使用 | |
|---|---|---|---|---|---|---|
| 加载中... | ||||||
一键导出配置
选择 API Key 和模型,自动生成各种工具的配置文件
配置导入与生成
选择 API Key、模型,再一键导入或生成配置文件
https://api.aicoming.top/v1https://api.aicoming.topCC Switch 一键导入 推荐
选择目标工具,一键导入配置到 CC Switch
—
安装 Codex CLI v0.137.0
OpenAI 官方终端编码代理。装好后用上方 CC Switch 或下方配置文件接入 AIComing
生成配置文件
选择目标工具,生成对应配置文件
API Keys
所有密钥将仅在创建时完整显示一次,请妥善保存
https://api.aicoming.top/v1
对话 / 图片 / 视频 统一同址
npx -y github:huatianwan/aicoming-skills
总路由
总路由智能最低价路由 · 自动覆盖你收藏的商家
加载中...
| 加载中... |
安全建议
调用日志
近 30 天的请求详情,点击查看 request/response
| 时间 | 状态 | 模型 | Key | tokens | 延迟 | 费用 | request_id |
|---|
工单
调用异常、充值问题、计费疑问都可以在这里提交,后续回复会保留在同一条工单里。
| ID | 标题 | 类型 | 状态 | 创建时间 | 最后更新 | |
|---|---|---|---|---|---|---|
| 加载中... | ||||||
创建工单
描述越具体,排查越快
AIComing API 技术文档
本文档提供 AIComing API 的完整接入指南。平台提供 OpenAI 兼容的统一接口,支持智能路由、自动故障转移、多供应商聚合与实时计费。以下章节覆盖从基础配置到高级用法的全部内容。
# 只改两处:Base URL + API Key
curl https://api.aicoming.top/v1/chat/completions \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{"role": "user", "content": "Hello AIComing"}
]
}'
创建 Key
在 API Keys 页面创建密钥。建议预先收藏 3 家以上供应商,确保路由引擎有充足的故障转移空间。
替换 Base URL
将客户端的 Base URL 修改为 https://api.aicoming.top/v1(对话、图片、视频统一同址,无请求超时限制)。
看日志排查
每次 API 调用均分配唯一 Request ID。如遇异常,可在调用日志中展开详情,查阅完整路由轨迹与计费记录。
§1 基础地址
本节说明 API 请求的基础 URL 与认证方式。所有兼容 OpenAI SDK 的客户端仅需修改 Base URL 即可接入。
aicoming.top 走 Cloudflare,有 100s 超时,适合 chat。api.aicoming.top 直连服务器,超时 10 分钟,适合 image/video。
§2 SDK 示例
以下代码示例演示如何使用主流 SDK 接入平台。所有示例仅需替换 base_url 和 api_key 两个参数。
from openai import OpenAI
client = OpenAI(
api_key="sk-your-key",
base_url="https://api.aicoming.top/v1",
)
response = client.chat.completions.create(
model="gpt-5.5",
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.AICOMING_API_KEY,
baseURL: 'https://api.aicoming.top/v1',
});
const completion = await client.chat.completions.create({
model: 'gpt-5.5',
messages: [{ role: 'user', content: 'Hello' }],
});
console.log(completion.choices[0].message.content);
curl https://api.aicoming.top/v1/chat/completions \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.5","messages":[{"role":"user","content":"你好"}]}'
§3 流式响应
设置 stream: true 后,服务端通过 Server-Sent Events (SSE) 协议逐 token 推送响应。
stream = client.chat.completions.create(
model="gpt-5.5",
messages=[{"role": "user", "content": "写一首诗"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="", flush=True)
const stream = await client.chat.completions.create({
model: 'gpt-5.5',
messages: [{ role: 'user', content: '写一首诗' }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content || '');
}
§4 Image API
统一调用 /v1/images/generations 端点。平台根据 size 参数自动路由至对应分辨率档位(1k/2k/4k),请求体包含 image 字段时自动切换为图生图模式。
model="gpt-image-2",按 max(宽,高) 自动选档:≤1024 → 1k · ≤2560 → 2k(默认) · ≤3840 → 4ksize 约束:宽高各被 16 整除 · 比例 1:3~3:1 · 总像素 655K~8.3M · 建议用
api.aicoming.top
import base64
resp = client.images.generate(
model="gpt-image-2",
prompt="赛博朋克城市夜景,霓虹灯倒映在街道",
size="1792x1024", # → 2k 档
quality="low",
n=1,
)
with open("out.png", "wb") as f:
f.write(base64.b64decode(resp.data[0].b64_json))
# extra_body 传 image 字段,平台自动走图生图
resp = client.images.generate(
model="gpt-image-2",
prompt="把服装换成居家服",
size="1792x1024",
quality="low",
n=1,
extra_body={
"image": [
"https://example.com/ref1.jpg",
"https://example.com/ref2.jpg",
]
},
)
curl https://api.aicoming.top/v1/images/generations \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "把背景换成海滩",
"image": ["https://example.com/photo.jpg"],
"size": "1024x1024",
"quality": "low", "n": 1
}'
image 字段自动切换),不参与 1k/2k/4k 分档。支持
aspect_ratio(1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9)与 image_size(1K / 2K / 4K),经 Gemini imageConfig 生效(实测 16:9 + 2K → 1408×768),不传用上游默认。单张约 20~170s(视渠道快慢,慢渠道可达 ~170s),建议用
api.aicoming.top 并把客户端超时设到 300s 以上;推荐 return_url:true,返回 OSS 链接(data[0].url)而非 base64。
import requests, base64
resp = requests.post(
"https://api.aicoming.top/v1/images/generations",
headers={"Authorization": "Bearer sk-your-key"},
json={"model": "nano-banana-pro",
"prompt": "一只橘猫坐在木桌上,柔和窗光,写实风格",
"aspect_ratio": "16:9", "image_size": "2K", # pro 生效(经 imageConfig)
"return_url": True, "n": 1},
timeout=300, # 单张约 20~170s,慢渠道更久
)
item = resp.json()["data"][0]
raw = requests.get(item["url"]).content if item.get("url") else base64.b64decode(item["b64_json"])
open("out.png", "wb").write(raw)
curl https://api.aicoming.top/v1/images/generations \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-pro",
"prompt": "保持人物和服装不变,背景换成樱花日式街道",
"image": "https://example.com/ref.jpg",
"return_url": true,
"n": 1
}'
"async": true:立即返回 202 + 任务 ID,用 GET /v1/images/generations/{id} 轮询结果,不用吊着长连接等图。· 任务状态:
processing(处理中)→ completed(完成,data[].url 可取)/ failed(失败,看 error.message)· 建议轮询间隔 ≥2 秒;不带
async 的老用法完全不变(服务端替你等完再返回)· 取图链接 1 小时有效,请及时下载保存;过期访问返回 410
· 该模型没有异步渠道时返回 400
async not supported for this model,退回同步调用即可
# 1. 提交(立即返回任务 ID)
curl https://api.aicoming.top/v1/images/generations \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"星空下的古老城堡","size":"2048x1152","async":true}'
# → 202 {"id":"imgtask_123","status":"processing",...}
# 2. 轮询(建议每 2 秒)
curl https://api.aicoming.top/v1/images/generations/imgtask_123 \
-H "Authorization: Bearer sk-your-key"
# → {"status":"completed","data":[{"url":"https://api.aicoming.top/v1/images/content/..."}]}
import requests, time
BASE = "https://api.aicoming.top/v1"
HEADERS = {"Authorization": "Bearer sk-your-key"}
task = requests.post(f"{BASE}/images/generations", headers=HEADERS, json={
"model": "gpt-image-2", "prompt": "星空下的古老城堡",
"size": "2048x1152", "async": True,
}).json()
while True:
r = requests.get(f"{BASE}/images/generations/{task['id']}", headers=HEADERS).json()
if r["status"] == "completed":
img = requests.get(r["data"][0]["url"]).content # 链接 1 小时有效,尽快下载
open("out.png", "wb").write(img)
break
if r["status"] == "failed":
raise RuntimeError(r["error"]["message"])
time.sleep(2)
"stream": true:以 SSE 事件流返回,事件为 image_generation.partial_image(渐显帧)/ image_generation.completed(最终图)/ error,data JSON 含 type / b64_json / partial_image_index / created_at。·
partial_images:渐显帧数量 0~3,默认 0。当前暂时关闭,传 >0 也不推渐显帧,仍以单个 completed 事件返回完整图;stream:true 不受影响,可正常使用·
stream:true 对所有生图模型可用:无流式渠道时服务端出图后以单个 completed 事件返回(伪流式)· 只按最终图计费,partial 帧免费;
stream 与 async 互斥(400),流式仅支持 n=1(400)
curl -N https://aicoming.top/v1/images/generations \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"model":"gpt-image-2-1k","prompt":"a cat","stream":true,"partial_images":2}'
# event: image_generation.partial_image
# data: {"type":"image_generation.partial_image","b64_json":"...","partial_image_index":0,"created_at":1779622166}
# event: image_generation.completed
# data: {"type":"image_generation.completed","b64_json":"...","created_at":1779622180}
import requests, json, base64
# 请求体 = 普通生图请求 + "stream": true(size/quality/图生图 image 字段照常带)
with requests.post(
"https://api.aicoming.top/v1/images/generations",
headers={"Authorization": "Bearer sk-your-key"},
json={
"model": "gpt-image-2",
"prompt": "a cat",
"size": "1024x1024",
"stream": True, # 开启 SSE 流式
# "partial_images": 2, # 渐显帧(当前暂关闭,可省)
# "image": ["https://.../ref.jpg"], # 图生图时加此字段
},
stream=True, timeout=300,
) as resp:
for line in resp.iter_lines():
if not line or not line.startswith(b"data: "):
continue
ev = json.loads(line[6:])
if ev["type"] == "image_generation.completed":
open("out.png", "wb").write(base64.b64decode(ev["b64_json"]))
elif ev["type"] == "error":
raise RuntimeError(ev["error"]["message"])
§5 Responses API
兼容 OpenAI Codex 协议的 /v1/responses 端点,支持同步与流式两种调用方式。
curl https://api.aicoming.top/v1/responses \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.5","input":"用 Python 写快排","stream":false}'
§6 模型与计费
平台聚合多家供应商的模型资源。同一模型在不同供应商处可能存在价格差异,最终调用方由路由策略决定。
GET /v1/models 返回所有可用模型及价格。缓存价格:支持 prompt caching 的模型,缓存读取 token 按更低的缓存价计费;缓存创建 token 按输入价 ×1.25(5 分钟 TTL)/ ×2(1 小时 TTL)计,调用日志详情可查看创建缓存 token 数。
余额:实时扣费,余额归 0 时返回 HTTP 429。
§7 智能路由
路由引擎根据 API Key 绑定的策略,从你收藏的供应商中选择最优端点。失败时自动逐家轮询全部可用收藏商家,直到成功或全部失败(无需手动设置最大尝试数)。
计费:按最终成功的商家价格结算,中途失败的重试不收费。
X-Aicoming-Provider: <商家 slug 或 id>,即可把这次调用锁定到某一个商家——同一把 Key 灵活切换,无需另建 Key。只能锁定到该 Key 本来就允许的商家(收藏 / 指派范围内);超出范围或商家不存在返回
400 pinned_provider_not_available,绝不改路由到别家。不带该头即正常智能路由。响应头 X-Provider-ID 会回显实际命中的商家。
§8 错误码
错误响应遵循 OpenAI 错误格式。可使用响应头中的 Request ID 在调用日志中检索完整诊断信息。
401unauthorized — Key 不存在或已禁用,检查 API Keys 页面。
400model_not_supported — Key 绑定的商家不支持此模型,去收藏支持该模型的供应商。
400providers_not_favorited — Key 的商家未在收藏列表中,去"收藏店铺"重新收藏。
400pinned_provider_not_available — 请求头 X-Aicoming-Provider 指定的商家不在该 Key 允许范围内、或不存在。
429insufficient_balance — 余额不足,充值后恢复。
429rate_limited — 频率限制,降低并发或联系客服。
502all_providers_failed — 所有商家返回错误,上游临时故障。
503providers_unavailable — 所有商家不可用,增加更多收藏商家。
§9 客户端配置
以下列出主流 AI 工具的配置方法。所有支持 OpenAI-compatible 接口的客户端均可接入。
OPENAI_BASE_URL=https://api.aicoming.top/v1
OPENAI_API_KEY=sk-your-key
export ANTHROPIC_BASE_URL=https://api.aicoming.top/v1
export ANTHROPIC_API_KEY=sk-your-key
Settings → Models → OpenAI API Key
API Key: sk-your-key
Base URL: https://api.aicoming.top/v1
Override OpenAI Base URL: ✅
设置 → 模型提供商 → 添加自定义提供商
名称: AIComing API 地址: https://api.aicoming.top
API Key: sk-your-key 路径前缀: /v1
设置 → 翻译服务 → OpenAI
API URL: https://api.aicoming.top/v1/chat/completions
API Key: sk-your-key 模型: gpt-5.5
§10 AI 助手技能(Skill)
给 Claude Code / Codex 装上 AIComing 技能后,直接对助手说人话即可干活:「用 aicoming 生成一张赛博朋克的猫」「查一下我 aicoming 余额」「用 gpt-5.5 和 claude 各答一遍对比」——助手会拿你的 API Key 自动完成调用、存图、轮询。开源仓库:github.com/huatianwan/aicoming-skills
git clone https://github.com/huatianwan/aicoming-skills.git
cp -r aicoming-skills/aicoming ~/.claude/skills/aicoming
export AICOMING_API_KEY="sk-your-key"
git clone https://github.com/huatianwan/aicoming-skills.git
cp -r aicoming-skills/aicoming ~/.codex/skills/aicoming
export AICOMING_API_KEY="sk-your-key"
# ~/.codex/config.toml 顶部加(否则调用被沙箱拦截报"无法连接"):
# sandbox_mode = "workspace-write"
# [sandbox_workspace_write]
# network_access = true
对助手说:
"用 aicoming 生成一张极简风格的山峰日出图,保存为 sunrise.png"
"查一下我 aicoming 还剩多少钱"
"aicoming 上有哪些图片模型?"
"把这个项目的 OpenAI 调用切到 aicoming"
🧪 模型调试台
选择 Key 与模型,发真实请求测试;右侧实时生成可直接复制的调用代码
通知设置
账单与充值
选择充值金额
兑换码 / 优惠码
输入兑换码后直接充值到账,并同步账单与余额
代金券 / 优惠券
账单明细
充值、消费与赠送记录
| 时间 | 类型 | 说明 | 金额 | 余额 |
|---|---|---|---|---|
| 加载中... | ||||
邀一位朋友加入 AIComing
双方各得 500 积分
被邀请者完成首次充值(≥1 ¥)后,你额外获得 1,000 积分;对方调用额达 ¥10 后,你反返 5% 活跃金,最高 ¥500/人。
邀请记录
被邀请者完成首充后、奖励自动到账
| 朋友 | 注册时间 | 状态 | 获得积分 |
|---|---|---|---|
| 加载中... | |||
积分明细
玩法说明
供应商控制台
本月收益 — · 待结算 — · — 个接入
待办事项
结算余额
我的模型
接入管理
管理已接入的模型与端点
| 模型 / 端点 | 报价 | 利润 | 调用 ⇅ | 路由命中 | 探活 ⇅ | 延迟 ⇅ | 状态 ⇅ | 操作 | ||
|---|---|---|---|---|---|---|---|---|---|---|
| 加载中... | ||||||||||
已提交审核
模型「—」已提交。
审核通常在 4 小时内完成,结果通过站内信通知。
收益结算
加载中...
待对账明细
每日收入自动对账,完成后进入可提现余额
| 周期 | 应得收入 | 平台流水 | 抽佣 | 状态 | 说明 | 操作 |
|---|---|---|---|---|---|---|
| 正在加载待对账记录... | ||||||
收益趋势
每日净收益走势
提现账户
按模型收入分解
各模型调用量与收入占比
每日模型调用明细
按天查看各模型调用量 / 成功率 / Tokens / 收益
等级升级进度
每日收益明细 ?
| 日期 | 调用量 | Tokens | 平台流水 | 抽佣 | 净收益 |
|---|---|---|---|---|---|
| 加载中... | |||||
转入后即刻到账你的账户余额,可直接用于平台 API 调用消费。此操作不可撤销,转入金额将从可提现收益中扣除。
提现仅支持本人对私银行卡。姓名 / 身份证 / 卡号 / 预留手机将用于银行卡四要素核验与打款(信息加密保存,仅末位展示);提交后即为你发起开户,进入财务复核。手续费由提现方承担(到账金额 = 申请金额 − 手续费)。
供应商接入规范
从入驻到上架的完整指南 · v1.0
供应商设置
店铺资料、收款方式、审核通知与安全偏好
店铺资料
展示在模型市场和调用方账单里的供应商信息
收款与结算
收益结算前请完善收款资料,修改敏感信息需重新验证
审核与端点通知
提交记录
模型、提现、资料变更等供应商事项 · 审核中可修改重提 · 审核后也可更新
端点管理
上游API端点配置与健康状态监控
商家认证
管理认证资料、对公账户和商家等级
协议
签署与管理平台协议
平台曝光
查看曝光、点击、转化和排名数据
商家评分
综合评分、等级和升级路径
工单告警
管理工单、告警规则和异常处理
报错日志
查看最近的 API 调用错误,快速定位问题
| 时间 | 状态 | 模型 | HTTP | 错误信息 | 延迟 | Request ID |
|---|---|---|---|---|---|---|
| 点击刷新加载数据 | ||||||
分站总览
分站运营数据概览
分站信息
近7日收益趋势
用户管理
管理分站下注册用户
| 用户名 | 邮箱 | 状态 | 信用等级 | 注册时间 | 最近登录 | 操作 |
|---|---|---|---|---|---|---|
| 加载中... | ||||||
模型与定价
控制分站可用模型及自定义定价
全局加价率
所有未单独定价的模型默认按此比例加价
| 模型 | 供应商 | 类型 | 基础报价 | 分站报价 | 启用 | 操作 | ||
|---|---|---|---|---|---|---|---|---|
| 加载中... | ||||||||
收益结算
加载中...
每日收益明细
| 日期 | 调用量 | 收入 | 成本 | 利润 |
|---|---|---|---|---|
| 加载中... | ||||
数据分析
调用量与收益趋势
每日趋势
模型拆解
| 模型 | 调用量 | Tokens | 收入 | 占比 |
|---|---|---|---|---|
| 加载中... | ||||
公告管理
向分站用户发布通知
| 标题 | 类型 | 置顶 | 状态 | 发布时间 | 操作 |
|---|---|---|---|---|---|
| 加载中... | |||||
套餐管理
管理分站用户套餐
| 套餐名 | 代码 | 月价 | 流量费率 | 请求上限 | 状态 | 自定义 |
|---|---|---|---|---|---|---|
| 加载中... | ||||||
分站设置
基本配置与域名管理
基本信息
设置
账户、安全、通知、计费偏好等
个人资料
邮箱验证
确认用于找回密码和安全通知的邮箱。
双重验证
正在检查可用状态...
登录密码
账户与计费
API 与服务
营销与推广
界面偏好
API 默认参数
未显式指定时使用的默认值
收款账户
每月 5 日结算到默认账户
结算偏好
店铺身份
Logo 与唯一标识,展示在市场和调用方账单中
透明背景最佳
店铺详情
调用方在模型市场看到的公开信息
开放策略
控制调用方在你的店铺页面看到哪些信息
高危操作
以下操作不可逆,请谨慎