苏姆卡皮首页 / 能力与场景
能力与场景
苏姆卡皮 · OpenAI 兼容 AI API 网关 · Base URL https://sub.sumcapi.top/v1
按任务选能力：文本与推理、图像生成与编辑、视频生成，都通过同一个 OpenAI 兼容 Base URL 调用，换模型不换代码。
能力与场景
先确定要完成的任务，再选能力与模型，最后按密钥拆分配额与账单。苏姆卡皮把这三步收敛在同一套接口契约里。
任务到接口的映射
| 你要做的事 | 推荐能力 | 主要接口 | 典型场景 |
|---|---|---|---|
| 问答、写作、摘要、抽取 | 文本与推理 | /v1/chat/completions | 智能客服、内容生产、研报生成 |
| 代码补全、Agent 工具链 | 文本与推理 | /v1/chat/completions、/v1/responses | 代码辅助、自动化流水线 |
| Claude 生态与长上下文 | 文本与推理 | /v1/messages | Claude Code、长文档处理 |
| 海报、商品图、封面 | 图像生成 | /v1/images/generations | 电商视觉、营销素材批量 |
| 改风格、局部重绘、抠图 | 图像编辑 | /v1/images/edits | 素材二次加工 |
| 短视频素材、分镜预览 | 视频生成 | /v1/videos | 内容批量、广告测试 |
为什么用统一网关而不是逐家接入
- 接口契约统一：业务代码只依赖一套请求/响应结构，上游模型换代时不需要重写调用层。
- 路由与兜底：同一能力可以配置多个上游，失败或限流时自动切换到可用渠道，不用自己写重试与熔断。
- 配额与成本可视：按密钥、按项目统计 token 与调用次数，预算与账单一次对齐。
- 权限收敛：外部协作方只拿到网关密钥，上游凭证不下发到业务侧。
三种常见的接入路线
- 先跑通：保留原有 OpenAI SDK，只替换
base_url与api_key，验证链路后再逐步迁移其余模块。 - 再做稳：为关键路径配置兜底模型与超时策略，把失败率与限流纳入观测面板。
- 后算清：按项目拆分密钥与分组，用用量报表定位高成本任务，再决定模型选型与提示词优化。
接入示例
from openai import OpenAI
client = OpenAI(
base_url="https://sub.sumcapi.top/v1",
api_key="sk-你的密钥",
)
resp = client.chat.completions.create(
model="替换为你在模型广场看到的模型名",
messages=[{"role": "user", "content": "用三句话解释向量数据库"}],
)
print(resp.choices[0].message.content)常见问题
能不能只接入一个模型？ 可以。只用一个模型时也建议走网关：换密钥、看用量、控配额都在控制台完成，业务侧零改动。
模型清单在哪里看？ 见 模型广场，按能力与厂商筛选；计费口径见 模型定价。
支持流式输出吗？ 支持 stream=true，与 OpenAI 官方行为一致，事件透传不做额外缓冲。
图像和视频怎么计费？ 图像按分辨率与张数、视频按时长与分辨率计费，明细见 模型定价。