新极途 API 开发文档

Base URL：https://aiapi.gway.dev。OpenAI SDK 的 base_url 使用 https://aiapi.gway.dev/v1，不要重复拼接 /v1。

所有示例使用占位密钥 YOUR_API_KEY。在本站创建调用令牌后，通过 Authorization: Bearer YOUR_API_KEY 认证。Apifox 个人访问令牌只用于管理文档，不能用于调用本站模型。模型名称、令牌权限、可用分组及价格以本站模型广场和 GET /v1/models 为准；示例名称不保证对所有账户可用。

快速开始

文本协议

POST /v1/chat/completions：OpenAI 对话、多轮消息、工具调用；多模态能力取决于模型。

POST /v1/completions：传统文本补全，只用于支持该格式的模型。

POST /v1/responses、POST /v1/responses/compact：Responses 与上下文压缩；压缩和工具能力取决于所选模型与渠道。本页不提供异步 background 响应或响应历史管理能力。

POST /v1/messages：Claude Messages；可使用 x-api-key: YOUR_API_KEY，并传 anthropic-version: 2023-06-01，或使用本站 Bearer 认证。

POST /v1beta/models/{model}:generateContent、:streamGenerateContent?alt=sse：Gemini 原生格式，可用 x-goog-api-key: YOUR_API_KEY。

文本不是固定流式。stream:false 返回完整 JSON；stream:true 返回 SSE。Chat SSE 逐条读取 data:，以 data: [DONE] 结束；Responses、Claude、Gemini 的事件格式分别沿用其协议，不要一律套用 Chat 的解析器。客户端应在收到完整结束事件后汇总内容和 usage；连接中断后不要直接认定任务未消费。

错误与重试

常见状态：400 参数或计费维度错误；401 认证失败；403 令牌/模型权限不足；404 资源或任务不存在；429 额度、并发或频率限制；5xx 网关/上游异常。错误体可能是 {"error":{"message":"...","type":"...","code":"..."}}，异步任务错误也可包含顶层 code、message。以实际 HTTP 状态与 message 为准。

400 应修正参数后重试；401/403 检查令牌和权限；429/可重试5xx 采用指数退避。视频和异步图片创建超时可能已经创建了任务，不要高频重复提交。保存创建响应中的本站任务 ID，查询只允许访问当前账户可见的任务。请求 ID 若响应提供，应一并保留用于排查。

接口存在不等于任意模型均支持该协议；先检查模型广场的端点和参数。文档不包含尚未实现的文件上传管理、图片 variations、fine-tuning 接口。所有资源示例地址只是格式示范，实际调用必须替换为可供上游读取的真实 URL。

接入与文本协议

新极途 API 开发文档#

快速开始#

文本协议#

错误与重试#

新极途 API 开发文档

快速开始

文本协议

错误与重试