DEVELOPER DOCS

五分钟完成接入

提供 OpenAI、Anthropic Messages、Responses 与 Gemini 兼容接口。接入前请确认模型、协议和工具支持范围。

01

发送第一个请求

在控制台创建 API Key,然后运行下面的命令:

先在控制台创建 API Key,把下方占位值替换为自己的密钥,并在运行示例的同一终端执行。后续 curl、SDK 与客户端配置均读取此环境变量。

Shell · 设置 API Key
export KIMISEEK_API_KEY="ks-your-key"
Shell
curl https://api.kimiseek.app/v1/chat/completions \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?请先在当前终端设置 KIMISEEK_API_KEY。}" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "deepseek-v4-pro-0813",
  "max_completion_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello from KimiSeek"
    }
  ]
}'
02

身份认证

使用 KimiSeek API Key:OpenAI 接口通过 Authorization: Bearer 传入,Anthropic Messages 也可使用 x-api-key。密钥以 ks- 开头,可在控制台密钥列表中复制。

安全提示

不要把 API Key 放在浏览器代码或公开仓库中。

03

支持的模型与价格

调用时请把下表中的模型 ID 原样填入 model 字段。价格为 KimiSeek 当前实时请求售价。

模型与调用名称计费区间输入缓存输入输出上下文
DeepSeek V4 Pro 0813deepseek-v4-pro-0813别名: deepseek-v4-pro当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。峰时 (UTC 01:00–04:00, 06:00–10:00(北京时间 09:00–12:00, 14:00–18:00)) · 分时计价自 2026-08-20 13:03:49.577 UTC 起;此前全天按峰时价¥4.5¥0.15¥13.51M
谷时 (除 UTC 01:00–04:00, 06:00–10:00(北京时间 09:00–12:00, 14:00–18:00) 外) · 分时计价自 2026-08-20 13:03:49.577 UTC 起;此前全天按峰时价¥2.25¥0.075¥6.75
DeepSeek V4.1 Flashdeepseek-v4.1-flash别名: deepseek-flash当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。谷时 (除 UTC 01:00–04:00, 06:00–10:00(北京时间 09:00–12:00, 14:00–18:00) 外) · 分时计价自 2026-08-16 16:00:00.000 UTC 起;此前全天按峰时价¥0.5¥0.01¥21M
峰时 (UTC 01:00–04:00, 06:00–10:00(北京时间 09:00–12:00, 14:00–18:00)) · 分时计价自 2026-08-16 16:00:00.000 UTC 起;此前全天按峰时价¥1¥0.02¥4
Qwen4 Maxqwen4-max当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。标准¥8.5¥0.425¥25.51M
GLM-5.3 Flashglm-5.3-flash当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。标准¥0.4¥0.115¥1.41M
Qwen3.8 Maxqwen3.8-max当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。标准¥6¥0.75¥18991K
GLM-5.3glm-5.3别名: GLM-5.3当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。标准¥4¥1¥141.024M
Kimi K3kimi/kimi-k3别名: kimi-k3当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。标准¥16¥1.6¥801.048576M
Kimi K3.1 Pro Highspeedkimi/kimi-k3.1-pro-highspeed别名: kimi-k3.1别名: kimi-k3.1-pro当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。标准¥13¥0.65¥681.048576M
Qwen3.8 Flashqwen3.8-flash当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。标准¥0.4¥0.05¥1.351M
Qwen3.8 27Bqwen3.8-27b当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。标准¥0.9¥0.18¥3.61M
Qwen3.8 2.4T A95Bqwen3.8-2.4t-a95b当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。标准¥9.6¥1.2¥28.81M
Qwen3.7 Maxqwen3.7-max当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。标准¥6¥1.2¥18991K
Qwen3.6 Plusqwen3.6-plus当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。输入 ≤ 256,000 Token¥1.6同输入价¥9.61M
输入 ≥ 256,001 Token¥6.4同输入价¥38.4
Qwen3.7 Plusqwen3.7-plus当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。输入 ≤ 256,000 Token¥1.6¥0.32¥6.41M
输入 ≥ 256,001 Token¥4.8¥0.96¥19.2
DeepSeek V4.1 Flash 1017deepseek-v4.1-flash-1017当前可用协议:OpenAI Chat Completions · /v1/chat/completions · Responses /v1/responses; Anthropic Messages · /v1/messages; Gemini · /v1beta/models/{model}:generateContent。谷时 (除 UTC 01:00–04:00, 06:00–10:00(北京时间 09:00–12:00, 14:00–18:00) 外) · 分时计价自 2026-10-18 23:42:09.074 UTC 起;此前全天按峰时价¥0.5¥0.05¥21.024M
峰时 (UTC 01:00–04:00, 06:00–10:00(北京时间 09:00–12:00, 14:00–18:00)) · 分时计价自 2026-10-18 23:42:09.074 UTC 起;此前全天按峰时价¥1¥0.1¥4

图像模型价格

价格单位为人民币 / 张,售价按各模型当前折扣计算;参考图与输出图片分别计费。分辨率档位和提示词扩写价格见下表,未单列扩写价格时按普通输出价计费。

图像模型输入参考图 / 张输出图片 / 张扩写输出 / 张
Qwen Image 3.0 Proqwen-image-3.0-pro当前可用协议:OpenAI Images · /v1/images/generations。¥0.016262,144–2,250,000 像素¥0.22,250,001–4,194,304 像素¥0.4—
Qwen Image 3.0qwen-image-3.0当前可用协议:OpenAI Images · /v1/images/generations。¥0.016262,144–4,194,304 像素¥0.144—
Wan 2.7 Image Prowan2.7-image-pro当前可用协议:OpenAI Images · /v1/images/generations。¥0589,824–16,777,216 像素¥0.4—
Wan 2.7 Imagewan2.7-image当前可用协议:OpenAI Images · /v1/images/generations。¥0589,824–4,194,304 像素¥0.16—
Z-Image Turboz-image-turbo当前可用协议:OpenAI Images · /v1/images/generations。¥0262,144–4,194,304 像素¥0.08262,144–4,194,304 像素¥0.16

文本价格单位为人民币 / 百万 Token;按各模型的输入区间、请求开始时间和生效条件选择适用档位。 查看完整价格与显式缓存说明

也可通过公开的模型接口获取机器可读目录(无需 API Key): GET https://api.kimiseek.app/v1/models

调用示例

以下示例使用当前已配置的模型与协议;请使用你自己的 KimiSeek API Key。

Shell · OpenAI-compatible
curl https://api.kimiseek.app/v1/chat/completions \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?请先在当前终端设置 KIMISEEK_API_KEY。}" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "deepseek-v4-pro-0813",
  "max_completion_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello from KimiSeek"
    }
  ]
}'
Shell · Anthropic Messages
curl https://api.kimiseek.app/v1/messages \
  -H "x-api-key: ${KIMISEEK_API_KEY:?请先在当前终端设置 KIMISEEK_API_KEY。}" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "deepseek-v4-pro-0813",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello from KimiSeek"
    }
  ]
}'
Shell · OpenAI Responses
curl https://api.kimiseek.app/v1/responses \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?请先在当前终端设置 KIMISEEK_API_KEY。}" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "deepseek-v4-pro-0813",
  "input": "Hello from KimiSeek",
  "max_output_tokens": 1024
}'
Shell · Gemini
curl https://api.kimiseek.app/v1beta/models/deepseek-v4-pro-0813:generateContent \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?请先在当前终端设置 KIMISEEK_API_KEY。}" \
  -H "Content-Type: application/json" \
  -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Hello from KimiSeek"
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 1024
  }
}'

图片生成 API

使用 /v1/images/generations 调用图像模型;上传参考图时将 image 设置为 HTTPS 地址或 image data URL。

Shell · Images API
curl https://api.kimiseek.app/v1/images/generations \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?请先在当前终端设置 KIMISEEK_API_KEY。}" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-3.0-pro",
  "prompt": "A red panda reading under a cedar tree",
  "size": "1024x1024",
  "n": 1,
  "prompt_extend": false
}'

使用官方 OpenAI SDK

切换模型时只修改 model。平台会把请求转发至该模型对应的上游渠道。

TypeScript · OpenAI SDK
import OpenAI from "openai";

const apiKey = process.env.KIMISEEK_API_KEY;
if (!apiKey) throw new Error("请先在当前终端设置 KIMISEEK_API_KEY。");

const client = new OpenAI({
  apiKey,
  baseURL: "https://api.kimiseek.app/v1",
});

const reply = await client.chat.completions.create({
  model: "deepseek-v4-pro-0813",
  messages: [{ role: "user", content: "Hello from KimiSeek!" }],
  max_completion_tokens: 1024,
});
04

接入 Claude Code 与 Codex

使用 CC Switch 配置

通过 CC Switch 的图形界面,为 Codex 和 Claude Code 分别添加 KimiSeek 供应商。

  1. 先在控制台创建或复制 KimiSeek API Key。 打开 API Key 管理
  2. 打开 CC Switch,切换到要配置的 Codex 或 Claude Code,添加自定义供应商;已有供应商可直接编辑。
  3. 填写以下供应商信息。官网链接和备注为可选项,可留空。
    供应商名称
    kimiseek
    API Key
    填写你自己的 KimiSeek API Key(以 ks- 开头)
    默认模型
    截图以 glm-5.3-flash 为例;也可从上方模型目录复制当前可用的模型 ID。
  4. 按下方对应客户端填写 API 请求地址(Base URL),保持「完整 URL」开关关闭。
  5. 点击「保存」,在对应客户端的供应商列表中启用 KimiSeek,再重新启动该客户端。两个客户端都要使用时,请分别配置并启用。

Codex

默认模型: deepseek-v4-pro-0813

Codex 的 Base URL 必须带 /v1 后缀。
API 请求地址 · Base URL
https://api.kimiseek.app/v1
CC Switch · Codex · https://api.kimiseek.app/v1
Codex · 配置截图(点击查看原图)

Claude Code

默认模型: deepseek-v4.1-flash

Claude Code 的 Base URL 不带 /v1 后缀。
API 请求地址 · Base URL
https://api.kimiseek.app/
CC Switch · Claude Code · https://api.kimiseek.app/
Claude Code · 配置截图(点击查看原图)

Claude Code 通过 Anthropic Messages 兼容层调用模型。

Shell · Claude Code
export ANTHROPIC_BASE_URL="https://api.kimiseek.app"
export ANTHROPIC_MODEL='deepseek-v4.1-flash'
export ANTHROPIC_AUTH_TOKEN="${KIMISEEK_API_KEY:?请先在当前终端设置 KIMISEEK_API_KEY。}" && claude

Codex 使用 Responses API,并从环境变量读取 KIMISEEK_API_KEY。

Responses 客户端工具目前只支持平铺 function;custom、namespace 和托管工具会被丢弃,不会执行。工具支持范围: Codex · Responses

TOML · Codex
model = "deepseek-v4-pro-0813"
model_provider = "kimiseek"

[model_providers.kimiseek]
name = "KimiSeek"
base_url = "https://api.kimiseek.app/v1"
env_key = "KIMISEEK_API_KEY"
wire_api = "responses"
Gemini 协议

generateContent 与 streamGenerateContent 仅支持 parts[].text 文本输入,可用 x-goog-api-key 传入密钥。不支持图片、文件、tools、toolConfig 或函数调用历史;这些请求在转发和计费前返回 HTTP 400。工具调用请使用其他兼容接口和支持工具的模型。 仅支持文本输出;音频或图片生成请求也在转发和计费前返回 HTTP 400。

05

流式输出

设置 stream: true 获取标准 SSE。流正常结束或中断时,平台会结算已经产生的用量。

错误码

400请求或模型名称不正确401API Key 无效或额度耗尽402账户人民币余额不足503模型通道未配置或暂不可用

人民币计费

费用由输入、缓存输入和输出 Token 乘以对应单价组成,全部以人民币结算。

余额与消费阈值

每次请求会从账户和密钥的剩余额度中预留预计费用(至少 ¥0.10);进行中请求及待结算费用也会占用额度。额度不足时暂停新调用,可等待请求完成或调低输出及独立思考预算。

每个账户最多同时运行 4 个模型请求。预留不等于扣费,最终按实际用量结算;若上游用量超过估算,仍会补记差额,余额可能为负;充值先抵扣欠额。未设置输出上限时,按模型最大输出量预留;独立思考预算另计,未明确设置时保守按上下文上限预留。

三分钟跑通第一次调用

注册后创建 API Key。调用费用从账户余额扣除。新用户首充 7 折。充 ¥500,实付 ¥350,到账 ¥500。充 ¥1000,实付 ¥850,到账 ¥1000 最低充值仍为 ¥10,适合试用。