快速开始

5 分钟内完成第一次 kukuai.fyi 模型调用。无需改造已有 OpenAI 代码，只需替换 base_url 与 API Key。

请前往 https://kukuai.fyi 控制台注册并创建 API Key，再回到本页把它粘贴到下面的环境变量里使用。

登录 kukuai.fyi 控制台，前往「API Keys」页面创建一把新的密钥；
把它注入本地环境变量，避免泄露到代码仓库：

bash

export KUKUAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx

提示：所有调用都通过统一域名 kukuai.fyi，端口 443，HTTPS。

可选服务端点

kukuai.fyi 当前通过 sub-router 公开统一代理端点，本文档默认使用 https://www.kukuai.fyi/api-proxy/china/v1。

https://www.kukuai.fyi/api-proxy/china/v1 — 推荐端点，通过 kukuai.fyi 的 API 代理转发。

API Key、模型、协议和字段都保持一致。旧上游线路由 sub-router 内部管理，用户侧一般不需要直接填写。

使用 cURL 发送请求

下面这条命令会向 claude-opus-4-8 发起一次非流式 chat completion：

bash

curl https://www.kukuai.fyi/api-proxy/china/v1/chat/completions \
  -H "Authorization: Bearer $KUKUAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "stream": false,
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "用一句话介绍 kukuai.fyi"}
    ]
  }'

预期返回（精简示意，字段顺序可能略有不同）：

json

{
  "id": "chatcmpl-xxxxxxxx",
  "object": "chat.completion",
  "created": 1730000000,
  "model": "claude-opus-4-8",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "kukuai.fyi 是一个统一的大模型 API 网关，OpenAI 兼容协议，多模型一站接入。"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 28,
    "total_tokens": 52
  }
}

使用官方 SDK

kukuai.fyi 完全兼容 OpenAI 协议。任何支持 OpenAI 的官方/社区 SDK，只要把 base_url 指向 https://www.kukuai.fyi/api-proxy/china/v1 即可使用。

Python

main.pypython

from openai import OpenAI

client = OpenAI(
    base_url="https://www.kukuai.fyi/api-proxy/china/v1",
    api_key="YOUR_KUKUAI_API_KEY",
)

resp = client.chat.completions.create(
    model="claude-opus-4-8",
    messages=[
        {"role": "user", "content": "用一句话介绍 kukuai.fyi"},
    ],
)

print(resp.choices[0].message.content)

Node.js

index.tstypescript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://www.kukuai.fyi/api-proxy/china/v1",
  apiKey: process.env.KUKUAI_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "claude-opus-4-8",
  messages: [{ role: "user", content: "用一句话介绍 kukuai.fyi" }],
});

console.log(resp.choices[0].message.content);

下一步

查看完整的 Chat Completions 接口字段；
浏览模型导航，挑选最适合你场景的模型；
了解错误码，让你的客户端在异常情况下更稳健。
把当前配置导出给 Claude Code、Cursor、Python SDK 等工具：配置文件导出。
阅读通用教程，理解 Claude / OpenAI 兼容接入方式：通用教程。

快速开始 ​

可选服务端点 ​

使用 cURL 发送请求 ​

使用官方 SDK ​

Python ​

Node.js ​