aisplice

API 参考

旧接口与兼容

#OpenAI 兼容性

所有路径接收 OpenAI 请求体，厂商专属参数（如 anthropic tool_use、gemini thinking_config）原样透传。

响应结构与 OpenAI 完全一致

响应体与 OpenAI 完全一致，为 OpenAI 写的解析、重试和可观测性封装都能继续用。

本页的端点都是可用的、也照常计费，但它们不是推荐的接入方式。只有当你需要让现有厂商 SDK 原样继续工作，或者接手了一段暂时不打算迁移的调用时，才用它们。

#该用哪一套接口？

全新接入

用 API 参考里 OpenAI 形态的 /v1 端点。所有能力共用一套词汇，而且只有这一套会持续增加新参数。

已有厂商 SDK

用下面对应的透传路径：只改 base URL 和密钥，请求体仍用厂商自己的格式。

接手的历史调用

它会继续可用。下次改到这段代码时顺手迁移即可——这些路由是冻结状态，不再维护。

#厂商原生透传

这些路径接受厂商自己的请求体，也返回厂商自己的响应结构。认证仍然只有一个 Authorization: Bearer 头，用本平台的密钥——不使用厂商自己的鉴权方式。

Gemini 原生

透传

把 Google GenAI SDK 指向本网关即可，无需改代码。generateContent 的路径形态和请求体都是 Gemini 自己的。

GET/v1beta/models以 Gemini 的目录结构列出模型。
POST/v1beta/models/*Gemini 路径形态：/v1beta/models/{model}:{action}，例如 :generateContent 或 :streamGenerateContent。
POST/v1/models/*同样的 Gemini 请求形态，挂在 /v1 下，供无法修改 API 版本前缀的客户端使用。
POST/v1/engines/:model/embeddings通过历史的 engines 路径调用 Gemini 向量化。

可灵原生

透传

接受可灵官方请求体（model_name + prompt 及厂商自有字段），并返回其任务结构。

POST/kling/v1/videos/text2video以厂商自有请求体提交可灵文生视频任务。
POST/kling/v1/videos/image2video提交可灵图生视频任务。
GET/kling/v1/videos/text2video/:task_id轮询可灵文生视频任务。
GET/kling/v1/videos/image2video/:task_id轮询可灵图生视频任务。

即梦原生

透传

即梦官方的 Action 查询式 API。提交与取结果共用一个路径，由 Action 参数区分。

POST/jimeng/?Action=CVSync2AsyncSubmitTask&Version=2022-08-31在厂商请求体里用 req_key 和 prompt 提交任务。结尾的斜杠是必需的——/jimeng 会发生重定向，而多数 HTTP 客户端在 301 时会丢掉请求体。
POST/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31获取已提交任务的结果。

Suno 原生

透传

Suno 形态的音乐提交与查询。新接入建议用 /v1/music/generations——它返回的是平台统一的任务结构。

POST/suno/submit/:actionaction 取值为 music 或 lyrics。
POST/suno/fetch按 id 列表批量查询。
GET/suno/fetch/:id查询单个任务。
gemini-native.sh
# Google GenAI SDK: set the API endpoint, keep everything else.
curl "https://www.aisplice.store/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Say hello."}]}]
  }'

透传路径的响应属于厂商，不是我们的

这些路由的状态码、错误体和字段名都跟随上游厂商。平台的错误结构和文档里的错误码只适用于网关侧的拒绝，例如认证、额度和路由。

#冻结的历史路由

仍可路由、仍会计费，但不再变更：不加新参数，不保证支持新模型，除了当前可用的部分之外不做任何兼容承诺。

历史别名

冻结

仍会路由、仍会计费，但已冻结：不加新参数，也不做兼容承诺。下次改到调用方代码时请迁移。

POST/v1/completionsOpenAI 历史的 prompt 补全接口。请改用 /v1/chat/completions。
POST/v1/edits尽管名字如此，它实际走的是图片编辑格式。请改用 /v1/images/edits。
POST/v1/video/generations早于 OpenAI 形态的视频提交接口。请改用 POST /v1/videos。
GET/v1/video/generations/:task_id早于 OpenAI 形态的视频轮询接口。请改用 GET /v1/videos/{task_id}。

Midjourney 归档

冻结

只读。Midjourney 的付费提交已下线，仅保留查看历史任务及其归档图片的能力。

GET/mj/task/:id/fetch查看一个归档任务。
GET/mj/task/:id/image-seed读取归档图片的 seed。
GET/mj/image/:id返回归档图片。

#什么情况会返回 404

不支持的 OpenAI 接口根本不会注册。某个 OpenAI 路径返回 404，就意味着这里确实不提供该能力——不是临时缺口，我们也不会用一个恒返回 501 的路由来假装支持。

如何确认一个密钥到底能调什么

GET /v1/models 会列出该密钥允许调用的所有模型。再结合路径本身是否 404，就能区分「模型没有权限」和「端点不提供」。

还是没解决？

把请求 ID 或报错信息发给我们，我们来查。

上一页计费与余额接下来上线前检查