Apixly · API

OpenAI 兼容 API 网关：接入 GPT、Claude、图片与视频

通过 Apixly AI API 网关接入聊天、生图与生视频。支持的 OpenAI 兼容端点可沿用现有客户端，Claude 可使用 Anthropic Messages 协议。API Key 绑定的分组决定模型权限与价格。

更新日期: 2026-10-16

先让客户端、端点和模型对应起来

OpenAI SDK 的 base_url 设为 https://apixly.ai/v1，并使用 Apixly Key。Anthropic 兼容客户端通常使用 https://apixly.ai 作为基础域名，由客户端拼接 /v1/messages。Gemini 有自己的端点和鉴权头。协议兼容不意味着所有接口族、工具调用或媒体参数都能直接互换。

按所选端点的文档准备请求体并解析响应。OpenAI 风格使用 Authorization: Bearer；Anthropic Messages 使用 x-api-key 与 anthropic-version。模型 ID 应从当前目录或经过鉴权的 /v1/models 返回中复制，不要直接把界面展示名称当作请求 ID，也不要依靠旧截图猜测型号。

绑定公开分组，发送一条小请求

在开发者控制台创建 Key，并绑定可用分组。下方 GPT 示例需要 OpenAI 协议分组。先用一条短消息，不加流式、工具或媒体附件，确认 choices[0].message.content 中有完整回答，同时检查 usage，再到控制台核对对应扣费。若收到错误，先检查模型 ID、权限、余额和端点。

第一条完整请求成功后，再逐项启用流式或工具功能。生图和生视频请按各自指南处理异步任务、轮询和下载。创作工作室与网关共享账户余额，但每个模型、分组和规格仍各自定价；一种接入方式成功，并不自动证明所有模型能力都已完成验收。

接入现有开发工具与业务工作流

文档提供 Claude Code、Codex、图片生成、视频任务及 SDK 配置示例。n8n 目录还包含带输入校验、分类和人工复核队列的客服工单工作流。选择离业务最近的接入路径，从小批量开始验证可用输出和实际成本，再逐步扩大量级，避免一开始就把未核验路径用于客户流量。

API Key 应保存在服务端或开发工具支持的安全配置中，不能嵌入公开网页。用价格指南估算成本，用稳定性指南确定验收指标。上线后继续观察实际业务错误、延迟与账单；发生问题时提供请求或任务标识，并保持敏感密钥不进入日志和公开内容。

发送第一条请求

curl https://apixly.ai/v1/chat/completions \
  -H "Authorization: Bearer $APIXLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"Hello"}]}'

用现有 Python 客户端接入

先安装 openai Python 包。在服务端设置 APIXLY_API_KEY，并把 APIXLY_MODEL 设为当前 Key 可用的准确模型 ID。第一次使用文本模型，不预设工具、图片或流式能力。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIXLY_API_KEY"],
    base_url="https://apixly.ai/v1",
    timeout=120,
    max_retries=0,
)
response = client.chat.completions.create(
    model=os.environ["APIXLY_MODEL"],
    messages=[{"role": "user", "content": "Hello"}],
    stream=False,
)
content = response.choices[0].message.content
if not content:
    raise RuntimeError("No text result; inspect the response before continuing")
print(content)
print(response.usage)

示例输出完整文本和返回的 Token 用量。扩量前在控制台核对同一请求的用量记录与扣费，不要记录完整 API Key。可选功能需在同一模型与分组单独验证。

第一条请求失败时

401: 检查 Apixly Key 和 Authorization 请求头；ChatGPT 登录身份不能代替 API Key。
404: 核对 HTTP 方法、准确模型 ID 和 base URL。SDK 会拼接端点，不要重复添加 /v1。
429: 检查速率与并发限制；返回 Retry-After 时遵守等待时间，仅在可以安全重试时使用有上限的退避。
5xx / timeout: 保留请求标识和错误正文。结果不明的付费请求或任务应先核对状态，再决定是否重新提交。

常见问题

已有 OpenAI 应用是否必须重写？

对已支持的 OpenAI 兼容端点，通常先替换 base URL 与 API Key，再验证目标模型和所需功能。供应商专有功能、工具及媒体格式可能需要额外适配，不能仅凭协议名称承诺全部功能完全一致。

一个 Key 能调用所有模型吗？

可用范围取决于 Key 绑定的分组。需要同时确认分组协议族、支持的模型 ID 和当前价格。公开目录及接入文档提供选择依据；创建 Key 后还应发送实际请求完成验证。

来源与延伸阅读

Apixly · LearnLink Technology Limited · [email protected]