开发者接入文档

CK-FREEAI 深度兼容 OpenAI 官方接口规范。仅需替换 Base URL 与 API Key 即可在现有应用中无缝使用。

基础连接参数

配置项	参数值	说明
Base URL	`https://freeai.chuankangkk.top/v1`	标准 v1 根路径
认证方式	`Authorization: Bearer sk-xxx`	请求头认证
Content-Type	`application/json`	标准 JSON 格式
SSE 流式传输	支持	服务器推送事件 (SSE)

Claude Code 对接指南

Claude Code 原生支持 OpenAI 兼容格式，通过环境变量即可直接配置接入：

方式一：终端环境变量（推荐）

BASH

export ANTHROPIC_BASE_URL="https://freeai.chuankangkk.top/v1"
export ANTHROPIC_API_KEY="sk-你的Key"

# 启动 Claude Code 并指定模型（支持 gpt-6、claude-sonnet-5-5 等）
claude --model gpt-6

方式二：配置文件 (~/.claude/settings.json)

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://freeai.chuankangkk.top/v1",
    "ANTHROPIC_API_KEY": "sk-你的Key"
  }
}

Cline / VSCode 插件接入指南

Cline 官方专栏深度适配 VSCode / Cline 扩展，支持 nemotron-3.5-lightning-cline、nemotron-3-ultra-550b、inkling-cline、gemma-4-31b-cline 等免额度极客模型：

1. 打开 VSCode 左侧 Cline 扩展图标，点击顶部齿轮按钮进入设置 (Settings)
2. API Provider 选择：OpenAI Compatible
3. Base URL 填写：https://freeai.chuankangkk.top/v1
4. API Key 填写您的网关 Key：sk-你的Key
5. Model ID 填写 Cline 专栏模型名，如：nemotron-3.5-lightning-cline 或 nemotron-3-ultra-550b

CLINE JSON 配置

{
  "apiProvider": "openai",
  "openAiBaseUrl": "https://freeai.chuankangkk.top/v1",
  "openAiApiKey": "sk-你的Key",
  "openAiModelId": "nemotron-3.5-lightning-cline"
}

OpenCode Zen 免费专栏与思考等级指南

OpenCode Zen 官方免费专栏提供 100% 零消耗模型（包含 big-pickle、step-5-preview-zen、space-bunny-zen、nemotron-3.5-lightning-zen 等），原生支持多轮长上下文与深度思考推理 (reasoning_effort)：

1. 思考等级控制：请求体中携带 "reasoning_effort": "low" | "medium" | "high"，或在 Anthropic 协议下设置 thinking: { type: "enabled", budget_tokens: 4096 }，网关已全链路完成规范归一化映射。
2. 0 额度消耗保障：专栏模型全部直连官方上游通道，绝不回退任何付费通道，安全放开高并发与深度思考调用。
3. 思考链输出提取：流式响应携带 delta.reasoning_content，非流式响应携带 message.reasoning_content。

API 端点规范

POST /v1/chat/completions

OpenAI 标准聊天对话补全接口

参数	类型	必填	说明
`model`	string	true	模型别名，如 gpt-6、big-pickle、step-5-preview-zen
`messages`	array	true	消息数组（包含 role 与 content，支持 reasoning_content 多轮保真）
`reasoning_effort`	string	false	思考等级：`low` / `medium` / `high`。调节 Zen 与推理模型的思考 token 预算
`stream`	boolean	false	是否启用 SSE 流式输出，默认 false
`temperature`	number	false	采样温度 (0.0 ~ 2.0)

GET /v1/models

获取当前可用的全部模型别名列表。

POST /v1/images/generations

OpenAI 标准图像生成接口（model 使用 CK福利模型别名，如 ck-sdxl-lightning）。

POST /v1/audio/transcriptions · /v1/audio/speech

OpenAI 标准语音转写 / 语音合成接口（multipart 需带 model 字段或 ?model= 别名）。

POST /v1/embeddings

OpenAI 标准向量嵌入接口。

代码调用示例

Python (OpenAI SDK)

PYTHON

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的Key",
    base_url="https://freeai.chuankangkk.top/v1"
)

response = client.chat.completions.create(
    model="gpt-6",
    messages=[{"role": "user", "content": "你好，请介绍你自己"}],
    stream=True
)

for chunk in response:
    if not chunk.choices:
        continue
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Next.js / Vercel AI SDK

TYPESCRIPT

import { createOpenAI } from '@ai-sdk/openai';

const openai = createOpenAI({
  baseURL: 'https://freeai.chuankangkk.top/v1',
  apiKey: 'sk-你的Key',
});

const { textStream } = await openai('gpt-6').doStream({
  prompt: '介绍一下 Next.js App Router',
});

状态码与诊断

状态码	错误类型	排查建议
401	missing_api_key	请求头未提供 Authorization，请检查认证配置。
401	invalid_api_key	Key 无效或已到期，请在管理后台检查或续期。
404	model_not_supported	模型不支持或输入有误，请调用 /v1/models 查看可用模型。
429	rate_limit_exceeded	出口 IP 触发上游频率限制，请切换至美国节点重试。
502	bad_gateway	上游服务暂时繁忙或响应超时，请稍后重试。