DEVELOPER DOCS

5분 안에 연동

OpenAI, Anthropic Messages, Responses, Gemini와 호환됩니다. 키, Base URL, 모델명만 바꾸세요.

01

첫 요청 보내기

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

Shell
curl https://api.kimiseek.app/v1/chat/completions \
  -H "Authorization: Bearer $KIMISEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash-0731",
    "messages": [{"role":"user","content":"Hello"}],
    "stream": true
  }'
02

인증

모든 요청에 Bearer Token을 사용합니다. ks- 키는 대시보드 키 목록에서 복사할 수 있습니다.

보안

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

03

지원 모델 및 요금

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

모델 및 API ID요금 구간입력캐시 입력출력컨텍스트
DeepSeek V4 Pro 0813deepseek-v4-pro-0813별칭: deepseek-v4-pro피크(UTC 01:00–04:00, 06:00–10:00)¥6.75¥0.225¥20.251M
비피크(그 외 시간)¥3.375¥0.1125¥10.125
DeepSeek V4 Flash 0731deepseek-v4-flash-0731별칭: deepseek-v4-flash비피크(그 외 시간)¥1.125¥0.0375¥3.3751M
피크(UTC 01:00–04:00, 06:00–10:00)¥2.25¥0.075¥6.75
DeepSeek V4.1 Flashdeepseek-v4.1-flash별칭: deepseek-flash비피크(그 외 시간)¥0.8¥0.016¥3.21M
피크(UTC 01:00–04:00, 06:00–10:00)¥1.6¥0.032¥6.4
DeepSeek V4 Flash Vision Expdeepseek-v4-flash-vision-exp비피크(그 외 시간)¥0.98¥0.0196¥3.921M
피크(UTC 01:00–04:00, 06:00–10:00)¥1.96¥0.0392¥7.84
GLM-5.3 Flashglm-5.3-flash표준¥0.6¥0.1725¥2.11M
Qwen3.8 Maxqwen3.8-max표준¥9¥1.125¥27991K
DeepSeek V4.1 Flash 260910deepseek-v4-1-flash-260910별칭: deepseek-v4.1-flash-260910비피크(그 외 시간)¥0.9¥0.018¥3.61M
피크(UTC 01:00–04:00, 06:00–10:00)¥1.8¥0.036¥7.2
GLM-5.3glm-5.3별칭: GLM-5.3표준¥6¥1.5¥211.024M
Kimi K3kimi/kimi-k3별칭: kimi-k3표준¥16¥1.6¥801.048576M
GLM-5.2ZHIPU/GLM-5.2별칭: glm-5.2표준¥6¥1.5¥211M
Qwen3.8 Flashqwen3.8-flash표준¥0.64¥0.08¥2.161M
Qwen3.8 27Bqwen3.8-27b표준¥2.4¥0.48¥9.61M
Qwen3.8 2.4T A95Bqwen3.8-2.4t-a95b표준¥9.6¥1.2¥28.81M
Qwen3.7 Maxqwen3.7-max표준¥9.6¥1.92¥28.8991K
Qwen3.6 Plusqwen3.6-plus입력 ≤ 256K¥1.6입력 요금과 동일¥9.61M
입력 > 256K¥6.4입력 요금과 동일¥38.4
Qwen3.7 Plusqwen3.7-plus입력 ≤ 256K¥1.6¥0.32¥6.41M
입력 > 256K¥4.8¥0.96¥19.2

Image model pricing

Image models are billed per generated image. Qwen Image also charges for reference images; Z-Image Turbo uses the higher output rate when prompt enhancement is enabled.

Image modelInput / imageOutput / imageEnhanced output / image
Qwen Image 3.0 Proqwen-image-3.0-pro¥0.016¥0.2
Qwen Image 3.0qwen-image-3.0¥0.016¥0.144
Wan 2.7 Image Prowan2.7-image-pro¥0¥0.4
Wan 2.7 Imagewan2.7-image¥0¥0.16
Z-Image Turboz-image-turbo¥0¥0.08¥0.16

가격 단위는 100만 토큰당 CNY입니다. Plus는 입력 토큰 수, DeepSeek V4 모델은 요청 시작 시각으로 요금 구간을 선택합니다. Batch 및 명시적 캐시 전체 요금 보기

기계 판독 가능한 모델 목록: GET https://api.kimiseek.app/v1/models

DeepSeek V4 Flash 호출 예시

정식 ID deepseek-v4-flash-0731을 사용하며 짧은 별칭 deepseek-v4-flash도 지원합니다. 두 형식 모두 같은 KimiSeek API 키를 사용합니다.

Shell · OpenAI-compatible
curl https://api.kimiseek.app/v1/chat/completions \
  -H "Authorization: Bearer $KIMISEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash-0731",
    "messages": [{"role":"user","content":"Hello"}]
  }'
Shell · Anthropic Messages
curl https://api.kimiseek.app/v1/messages \
  -H "x-api-key: $KIMISEEK_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash-0731",
    "max_tokens": 1024,
    "messages": [{"role":"user","content":"Hello"}]
  }'

Image generation API

Call image models with /v1/images/generations. Set image to HTTPS references or image data URLs when editing.

Shell · Images API
curl https://api.kimiseek.app/v1/images/generations \
  -H "Authorization: Bearer $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
  }'

공식 OpenAI SDK 사용

model만 변경하면 됩니다. 요청은 각 모델에 설정된 업스트림으로 전달됩니다.

TypeScript · OpenAI SDK
import OpenAI from "openai";

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

const response = await client.chat.completions.create({
  model: "qwen3.7-plus",
  messages: [{ role: "user", content: "Analyze this code" }],
});
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

    스크린샷은 glm-5.3-flash를 사용합니다. 위 모델 목록에서 사용 가능한 모델 ID를 복사해도 됩니다.

  4. 클라이언트에 맞는 아래 API 요청 주소(Base URL)를 입력하고 전체 URL 스위치는 꺼 두세요.
  5. 저장한 다음 해당 클라이언트의 공급자 목록에서 KimiSeek를 활성화하고 클라이언트를 다시 시작하세요. 둘 다 사용하면 각각 설정하고 활성화하세요.

Codex

Codex의 Base URL에는 /v1 접미사가 필요합니다.
API 요청 주소 · Base URL
https://api.kimiseek.app/v1
CC Switch · Codex · https://api.kimiseek.app/v1
Codex · 설정 스크린샷(클릭하여 원본 보기)

Claude Code

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_AUTH_TOKEN="ks-your-key"
export ANTHROPIC_MODEL="deepseek-v4-pro-0813"

claude

Codex는 Responses API와 KIMISEEK_API_KEY 환경 변수를 사용합니다.

TOML · Codex
model = "qwen3.7-max"
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를 지원하며 x-goog-api-key로 키를 전달합니다.

05

스트리밍

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

오류 코드

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

CNY 요금

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