Polymodel API · v1

快速开始

Polymodel 提供 OpenAI 兼容的多模型聚合 API。把 OpenAI SDK 的 base_url 指向下面这个地址、用 sk-cm- 开头的 Key 鉴权,就可以调用 ChatGPT、Claude、DeepSeek、ChatGPT Image 2、 Gemini Nano Banana 2、Doubao Seedance 等模型。

Base URL: https://polymodel.io/api/v1

1. 第一个请求

API 控制台 创建一个 Key(创建时仅显示一次, 请立即保存),然后:

curl https://polymodel.io/api/v1/chat/completions \
  -H "Authorization: Bearer sk-cm-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "用一句话介绍你自己。"}]
  }'

用 OpenAI 官方 SDK 也一样,只改两行:

from openai import OpenAI

client = OpenAI(api_key="sk-cm-...", base_url="https://polymodel.io/api/v1")
resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "..."}],
)

2. 常用任务

流式响应

"stream": true 即得到 OpenAI 兼容的 SSE 流。 想拿最终 token 统计加 stream_options: { include_usage: true }

curl -N https://polymodel.io/api/v1/chat/completions \
  -H "Authorization: Bearer sk-cm-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"..."}],"stream":true}'

图片生成

/images/generations 兼容 OpenAI 图片接口。可用模型:gpt-image-2gemini-nano-banana-2。高吞吐调用请传"async": true,再用返回的 id 轮询/images/tasks/:id

curl https://polymodel.io/api/v1/images/generations \
  -H "Authorization: Bearer sk-cm-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"一只柴犬戴墨镜","size":"16:9","resolution":"1K","async":true}'
curl https://polymodel.io/api/v1/images/tasks/image_task_id \
  -H "Authorization: Bearer sk-cm-..."

视频生成

/videos/generations 提交异步 Seedance 任务;用返回的id 轮询 /videos/tasks/:id。可用模型:seedance-2-0seedance-2-0-fastgrok-imagine-1.5-video-apimart

curl https://polymodel.io/api/v1/videos/generations \
  -H "Authorization: Bearer sk-cm-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2-0-fast","prompt":"霓虹灯下的未来城市航拍","aspect_ratio":"16:9","resolution":"720p","duration":5}'
curl https://polymodel.io/api/v1/videos/tasks/video_task_id \
  -H "Authorization: Bearer sk-cm-..."

列出可用模型

curl https://polymodel.io/api/v1/models -H "Authorization: Bearer sk-cm-..."

仅返回当前 Key 可调用的 text / image / video 模型。Claude Opus 4.7 保留为网页 Max 权益。完整价格对照请看 模型广场

3. 参考

计费 & 鉴权
  • Header: Authorization: Bearer sk-cm-...
  • API 调用只扣充值积分(订阅月度积分仅网页会话用)
  • 账户最多保留 3 个 Key;撤销后立即失效,无法恢复
  • Key 创建后只显示一次,请立即保存到环境变量
速率与大小限制
限制项ProMax
通用 API30 RPM300 RPM
图片异步提交200 RPM300 RPM
图片任务轮询1000 RPM1500 RPM
请求体大小512 KB
单次消息数 / 字符200 / 64,000
并发视频任务2
同时持有 Key 数3

429 响应附 X-RateLimit-Remaining / X-RateLimit-Reset,按指数退避重试即可。

错误码
HTTPcode含义
401invalid_api_keyKey 不存在或已撤销
403api_key_pausedKey 被暂停
403api_key_expiredKey 已过期
403api_key_model_not_allowedKey 未授权该模型
402api_key_credit_limit_exceededKey 单独额度用完
402insufficient_credits账户余额不足
403content_filter内容被审核拦截
400unsupported_video_resolution该视频模型不支持请求的分辨率
413request_too_large请求体超过 512 KB
429rate_limit_exceeded超过 RPM
502upstream_error上游模型错误

下一步

  • API 控制台 — 创建、编辑(模型范围 / 额度 / 过期)、暂停、撤销 Key
  • 模型广场 — 浏览所有模型与价格
  • 充值 — 为 API 充值积分