DEVELOPER DOCS

5분 안에 연동

OpenAI, Anthropic Messages, Responses, Gemini 호환 API를 제공합니다. 연결 전에 모델, 프로토콜과 도구 지원 범위를 확인하세요.

01

첫 요청 보내기

대시보드에서 API 키를 만든 후 실행하세요.

대시보드에서 API 키를 만들고 아래 예시 값을 본인의 키로 바꾼 뒤, 예시를 실행할 터미널에서 설정하세요. curl, SDK, 클라이언트 설정은 이 환경 변수를 읽습니다.

Shell · API 키 설정
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

인증

OpenAI API에는 KimiSeek API 키를 Authorization: Bearer로 전달하세요. Anthropic Messages는 x-api-key도 지원합니다. ks- 키는 대시보드 키 목록에서 복사할 수 있습니다.

보안

브라우저 코드나 공개 저장소에 키를 노출하지 마세요.

03

지원 모델 및 요금

표의 모델 ID를 model 필드에 그대로 입력하세요. 요금은 실시간 요청에 적용되는 현재 KimiSeek 판매가입니다.

모델 및 API ID요금 구간입력캐시 입력출력컨텍스트
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.피크 (01:00–04:00, 06:00–10:00 UTC (Beijing time 09:00–12:00, 14:00–18:00)) · 시간대별 요금은 2026-08-20 13:03:49.577 UTC부터 적용되며, 그전에는 종일 피크 요금 적용¥4.5¥0.15¥13.51M
비피크 (01:00–04:00, 06:00–10:00 UTC (Beijing time 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.비피크 (01:00–04:00, 06:00–10:00 UTC (Beijing time 09:00–12:00, 14:00–18:00) 외 시간) · 시간대별 요금은 2026-08-16 16:00:00.000 UTC부터 적용되며, 그전에는 종일 피크 요금 적용¥0.5¥0.01¥21M
피크 (01:00–04:00, 06:00–10:00 UTC (Beijing time 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 토큰¥1.6입력 요금과 동일¥9.61M
입력 ≥ 256,001 토큰¥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 토큰¥1.6¥0.32¥6.41M
입력 ≥ 256,001 토큰¥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.비피크 (01:00–04:00, 06:00–10:00 UTC (Beijing time 09:00–12:00, 14:00–18:00) 외 시간) · 시간대별 요금은 2026-10-18 23:42:09.074 UTC부터 적용되며, 그전에는 종일 피크 요금 적용¥0.5¥0.05¥21.024M
피크 (01:00–04:00, 06:00–10:00 UTC (Beijing time 09:00–12:00, 14:00–18:00)) · 시간대별 요금은 2026-10-18 23:42:09.074 UTC부터 적용되며, 그전에는 종일 피크 요금 적용¥1¥0.1¥4

이미지 모델 요금

요금 단위는 장당 CNY이며 모델별 현재 할인이 적용됩니다. 참조 이미지와 출력 이미지는 별도 과금합니다. 해상도 및 프롬프트 확장 요금은 아래 표를 확인하세요. 확장 요금이 따로 없으면 일반 출력 요금을 적용합니다.

이미지 모델참조 이미지 / 장출력 이미지 / 장프롬프트 확장 시 / 장
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

텍스트 모델의 가격 단위는 100만 토큰당 CNY입니다. 각 모델의 입력 구간, 요청 시작 시각 및 요금 적용 시작 조건에 따라 구간이 결정됩니다. 전체 요금 및 명시적 캐시 안내

API Key가 필요 없는 공개 기계 판독 모델 목록: GET https://api.kimiseek.app/v1/models

API 호출 예시

아래 예시는 현재 설정된 모델과 프로토콜을 사용합니다. 본인의 KimiSeek API 키를 사용하세요.

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 참조 주소 또는 이미지 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 키를 만들거나 복사하세요. API 키 관리 열기
  2. CC Switch에서 Codex 또는 Claude Code를 선택하고 사용자 지정 공급자를 추가하거나 기존 공급자를 편집하세요.
  3. 아래 공급자 정보를 입력하세요. 웹사이트와 메모는 선택 사항으로 비워 둘 수 있습니다.
    공급자 이름
    kimiseek
    API Key
    본인의 KimiSeek API 키(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 호환 API를 사용합니다.

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으로 거부됩니다. 도구 호출은 다른 호환 API와 지원 모델을 사용하세요. 출력도 텍스트만 지원하며 오디오나 이미지 생성은 전달과 과금 전에 HTTP 400으로 거부됩니다.

05

스트리밍

stream: true로 표준 SSE를 받습니다. 정상 종료 또는 중단 시 이미 생성된 사용량을 정산합니다.

오류 코드

400잘못된 요청 또는 모델명401잘못된 키 또는 한도 소진402CNY 잔액 부족503모델 채널 사용 불가

CNY 요금

입력, 캐시 입력, 출력 토큰에 단가를 곱해 모두 CNY로 정산합니다.

잔액 및 지출 기준액

요청마다 계정과 키의 남은 한도에서 예상 비용(최소 ¥0.10)을 예약합니다. 진행 중 요청과 미정산 비용도 한도를 사용합니다. 부족하면 완료를 기다리거나 출력 또는 별도 사고 예산을 줄이세요.

계정당 모델 요청을 최대 4개 동시에 실행할 수 있습니다. 예약은 결제가 아니며 실제 사용량으로 정산합니다. 예상치를 넘은 사용량도 청구되어 잔액이 음수가 될 수 있습니다. 충전금은 미납액에 먼저 사용됩니다. 출력 한도를 생략하면 모델 최대 출력을 예약합니다. 별도 사고 예산도 포함하며, 지정하지 않으면 컨텍스트 한도로 보수적으로 예약합니다.

3분이면 첫 호출까지

가입 후 API 키를 만드세요. 호출 비용은 계정 잔액에서 차감됩니다. 첫 충전 30% 할인. ¥500 충전, 결제 ¥350, 잔액 ¥500 적립. ¥1000 충전, 결제 ¥850, 잔액 ¥1000 적립 최소 충전 금액은 그대로 ¥10이며, 시험용으로 사용할 수 있습니다.