快速开始 ↗
QUIKWIN DEVELOPER PLATFORM

一个 Key，接入
每一种 AI 能力。

快赢AI提供统一鉴权和三套明确分离的标准协议。根据客户端选择正确端点，即可接入文本、图像、音频与视频模型。

创建 API Key 查看接入地址 ↓
API 网关标准协议
OpenAI
quikwin.ai/v1
Anthropic
quikwin.ai

统一使用 sk-qw-... Key 鉴权

QUICK START

三步发起第一条请求

无需安装专用 SDK。兼容标准 OpenAI 客户端，并为 Codex 与 Claude Code 提供各自需要的原生协议。

01创建密钥

在控制台 API Keys 页面选择调用渠道并创建以 sk-qw- 开头的密钥；未选择时使用默认渠道。

02选择协议

普通 SDK 使用 Chat Completions；Codex 使用 Responses；Claude Code 使用 Anthropic Messages。

03发送请求

模型名称填写模型广场公布的模型 ID，用量会实时计入控制台。

cURL · 列出模型
curl https://quikwin.ai/v1/models \
  -H "Authorization: Bearer sk-qw-你的密钥"
AUTHENTICATION

认证与 Base URL

所有请求都通过 HTTPS 发送。密钥只应保存在服务端环境变量或受保护的客户端密钥库中。

统一鉴权

OpenAI 兼容端点使用 Authorization: Bearer sk-qw-...。Claude Code 使用 ANTHROPIC_AUTH_TOKEN，网关同样按 Bearer Token 验证。

用途Base URL主要客户端
OpenAI Chat Completionshttps://quikwin.ai/v1OpenAI SDK、OpenCode、OpenClaw
OpenAI Responseshttps://quikwin.ai/v1Codex CLI / IDE
Anthropic Messageshttps://quikwin.aiClaude Code
MODELS & BILLING

模型 ID 与点数计费

请求中的 model 必须使用模型广场展示的模型 ID。输入、输出、图像、音频与视频任务按各自点数规则计费。

推荐文本模型gpt-5.6-terraclaude-sonnet-5gemini-3.6-flash-tiered
重要规则

展示名称不等于模型 ID；上下文、工具调用与多模态能力以模型卡片和接口返回为准。

打开模型广场 →
OPENAI COMPATIBLE

Chat Completions

适用于 OpenAI SDK、常规后端服务、OpenCode 与 OpenClaw。端点为 POST /v1/chat/completions。

Python
from openai import OpenAI

client = OpenAI(
    base_url="https://quikwin.ai/v1",
    api_key="sk-qw-你的密钥",
)

response = client.chat.completions.create(
    model="claude-opus-5",
    messages=[{"role": "user", "content": "你好，快赢AI"}],
    max_tokens=4096,
    stream=True,
)
for chunk in response:
    text = chunk.choices[0].delta.content if chunk.choices else None
    if text:
        print(text, end="", flush=True)
Claude 流式与输出上限

Claude 模型支持 stream: true 与非流式调用。建议显式传入 max_tokens；若通过 Chat Completions 调用时省略，快赢AI会自动补充安全默认值。

OPENAI RESPONSES

Responses API

Codex 的自定义模型提供商使用 Responses 协议。仅支持 Chat Completions 的网关不能直接驱动 Codex。

cURL
curl https://quikwin.ai/v1/responses \
  -H "Authorization: Bearer sk-qw-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "input": "分析这个项目并给出实施计划"
  }'
协议不能混用

Codex 配置中的 wire_api 应为 responses。不要填写不存在的 chat-completions 值。

GPT Image 2 的 Responses 返回

直接使用 model=gpt-image-2 时，完成项统一返回 output[].type=image_generation_call，图片 base64 位于 output[].result。主模型请求只有在客户端真实发送 tools:[{"type":"image_generation"}] 时才会触发托管桥接；普通对话或仅配置 Responses Provider 不会自动增加这个工具。即使渠道 N 只返回临时 URL，网关也会安全下载并转换。

OPENAI IMAGES

Images API

OpenAI SDK 与图像客户端可直接调用 POST /v1/images/generations；图片编辑客户端使用 POST /v1/images/edits。GPT Image 2 默认返回标准 data[].b64_json。

cURL · GPT Image 2（会产生一次图片费用）
curl https://quikwin.ai/v1/images/generations \
  -H "Authorization: Bearer sk-qw-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张极简的蓝色产品海报",
    "size": "1024x1024",
    "n": 1
  }'
统一图像任务结果

通过 POST /v1/generations 提交的全部图像模型，在 completed 后统一提供 result.type=image 与 result.data[].format/url；多图结果使用 /content、/content/1、/content/2 依次下载。原有 output、billing 与扣点字段继续保留。

如果客户端明确传 response_format=url，Images API 会保留 URL 返回；省略该字段或传 b64_json 时返回 base64。Responses API 始终按 image_generation_call.result 返回 base64。

GPT Image 2 分辨率价格与多参考图

1K / 2K / 4K 分别为 4.812 / 11.328 / 16.992 点；异步接口可带 0–16 张参考图、n=1–10，并使用 resolution 与画幅比例控制输出。完成后只返回 n 张真实生成图，不会把输入参考图重复列入结果。

ANTHROPIC MESSAGES

Anthropic Messages

Claude Code 需要 Anthropic Messages 的请求结构、内容块、工具调用和 SSE 流式事件。

cURL
curl https://quikwin.ai/v1/messages \
  -H "Authorization: Bearer sk-qw-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "检查这段代码"}]
  }'
THIRD-PARTY CLIENT COMPATIBILITY

第三方客户端兼容：Codex++

Codex++ 是可选的第三方客户端，可按 OpenAI Responses 标准连接快赢AI；它不是快赢AI的生产网关或模型上游。

不是上游或二次中转

Codex++ 仅用于第三方客户端兼容性测试。快赢AI生产链路直接实现 OpenAI Responses；正式 Codex 请按“Codex（原生）”配置。

类型OpenAI / Responses API不要选择 Chat Completions
Base URLhttps://quikwin.ai/v1末尾 / 可省略
模型从 /v1/models 选择对话模型与图片模型是两条独立能力
不要填写 api.quikwin.ai

当前公开网关使用 quikwin.ai。只有在 api.quikwin.ai 已配置 DNS 和对应 TLS 证书后，才能使用该子域名；截图中的子域名会在发送请求前直接解析失败。

Provider Doctor 自检
curl https://quikwin.ai/v1/models \
  -H "Authorization: Bearer sk-qw-你的密钥"

curl https://quikwin.ai/v1/responses \
  -H "Authorization: Bearer sk-qw-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-terra","input":"只回复 OK"}'
Codex++ 不会凭自然语言自动注册生图工具

只有客户端请求体真实包含 tools:[{"type":"image_generation"}]，快赢AI才会把主模型的明确生图请求桥接到 gpt-image-2。若 Codex++ 版本没有发送该工具，请直接调用 /v1/images/generations，或在原生 Codex 中安装下方的快赢AI生图 Skill；仅填写 Provider、Base URL 和主模型不会获得生图能力。

自检含义：401 是 Key 无效；404 是 Base URL 或模型 ID 错误；429 是具体上游模型限流，协议本身已连接成功；5xx 才是网关或渠道异常。

DEVELOPER TOOL · CC

Claude Code

通过官方环境变量连接快赢AI Anthropic 网关，不要将 Claude Code 指向 OpenAI Chat Completions。

Terminal · zsh / bash
export ANTHROPIC_BASE_URL="https://quikwin.ai"
export ANTHROPIC_AUTH_TOKEN="sk-qw-你的密钥"
export ANTHROPIC_MODEL="claude-sonnet-5"

claude

启动后执行 /status 检查当前模型与认证状态。401 通常表示 Key 错误，404 通常表示 Base URL 或模型 ID 错误，429 表示当前模型渠道限流。

NATIVE OPENAI CODEX

原生 Codex CLI / IDE

原生 Codex 直接通过快赢AI的 OpenAI Responses 端点连接模型，不经过 Codex++ 或其他二次中转。

生产链路

原生 Codex → 快赢AI /v1/models 与 /v1/responses → 已配置模型渠道；中间不经过 Codex++。

~/.codex/config.toml
model = "gpt-5.6-terra"
model_provider = "quikwin"

[model_providers.quikwin]
name = "快赢AI"
base_url = "https://quikwin.ai/v1"
env_key = "QUIKWIN_API_KEY"
wire_api = "responses"
环境变量
export QUIKWIN_API_KEY="sk-qw-你的密钥"
Codex 自带 ImageGen 不跟随自定义 Provider

Codex 内置 $imagegen 是客户端托管能力，不会因为 model_provider="quikwin" 就改走快赢AI。需要调用本站 gpt-image-2 时，请打开Codex 快赢生图 Skill专页安装 $quikwin-imagegen。

快赢AI会对普通 OpenAI 客户端返回标准 data 模型列表，并对 Codex 带版本号的目录请求返回 Codex 模型元数据，两种客户端可以共用同一个端点。网关同时提供 codex-auto-review 专用兼容路由，供 Codex Guardian 自动审批与安全复核调用；日常编码仍请选择常规 GPT/Codex 模型。

DEVELOPER TOOL · VS CODE

VS Code

最稳定的方式是在 VS Code 集成终端运行 Claude Code 或 Codex。配置由工具自身的环境变量和配置文件管理。

1

先在系统终端配置按 Claude Code 或 Codex 章节设置环境变量和配置文件。

2

完全退出并重启 VS Code让扩展宿主与集成终端读取新的环境变量。

3

从集成终端验证运行 claude /status 或 codex。

不要虚构 settings.json 字段

只有扩展官方文档明确声明支持的字段才应写入 VS Code 设置。未知的 apiBase 或 endpoint 不会自动生效。

DEVELOPER TOOL · OPENCODE

OpenCode

使用 OpenAI Compatible Provider，将 Provider ID、凭据 ID 与模型前缀统一为 quikwin。

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "quikwin/gpt-5.6-terra",
  "provider": {
    "quikwin": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "快赢AI",
      "options": {
        "baseURL": "https://quikwin.ai/v1"
      },
      "models": {
        "gpt-5.6-terra": { "name": "GPT-5.6 Terra" }
      }
    }
  }
}
DEVELOPER TOOL · OPENCLAW

OpenClaw

在 models.providers 注册快赢AI，并选择与网关一致的 openai-completions 协议。

Provider 配置
{
  models: {
    providers: {
      quikwin: {
        baseUrl: "https://quikwin.ai/v1",
        apiKey: "${QUIKWIN_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra" }
        ]
      }
    }
  }
}
ERROR HANDLING

错误码

状态码含义处理方式
400请求格式或模型参数错误核对协议、model ID 和必填字段
401认证失败检查 Bearer Key、环境变量和 Key 状态
404路由或模型不存在检查 Base URL、端点和模型 ID
429达到 RPM、TPM 或账户限制退避重试或升级限额
5xx上游或网关暂时异常保留 request ID，指数退避后重试
PRODUCTION CONTRACT

上线前必须真实满足

文档描述的是快赢AI网关的目标协议契约。对外开放某个客户端前，后端必须通过对应协议的请求、流式事件、工具调用、错误码和 usage 字段验证。

✓

Chat Completions/v1/chat/completions 支持消息、工具调用、SSE 与 usage。

✓

Responses API/v1/responses 支持 Codex 所需事件流和工具调用。

✓

Anthropic Messages/v1/messages 支持 content blocks、tool_use 与 SSE。

已复制