[docs]

base_url 한 줄.
나머지는 그대로 둡니다.

csflow 는 OpenAI 호환과 Anthropic Messages 두 프로토콜을 같은 주소에서 받습니다. 쓰던 SDK·CLI·에디터를 그대로 두고 주소와 키만 바꾸면 됩니다.

5분 시작

키는 콘솔 → API 키에서 발급합니다. 발급 직후 한 번만 전체가 보이므로 그 자리에서 복사하세요.

curl

curl https://api.csflow.ai/v1/chat/completions \
  -H "Authorization: Bearer $CSFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "안녕"}]
  }'

Python (openai SDK)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.csflow.ai/v1",
    api_key="sk-...",
)
r = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "안녕"}],
)
print(r.choices[0].message.content)

TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.csflow.ai/v1",
  apiKey: process.env.CSFLOW_API_KEY,
});
const r = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "안녕" }],
});

Anthropic SDK

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.csflow.ai",
  apiKey: process.env.CSFLOW_API_KEY,
});
const r = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [{ role: "user", content: "안녕" }],
});

엔드포인트

POST https://api.csflow.ai/v1/chat/completions
OpenAI 호환 채팅. 스트리밍(SSE) 지원.

POST https://api.csflow.ai/v1/messages
Anthropic Messages 호환. Claude Code 가 쓰는 경로.

POST https://api.csflow.ai/v1/embeddings
임베딩.

GET https://api.csflow.ai/v1/models
쓸 수 있는 모델 목록.

GET https://api.csflow.ai/api/pricing
모델별 단가. 인증 없이 열려 있습니다.

인증은 Authorization: Bearer sk-... 헤더 하나입니다. Anthropic SDK 가 보내는 x-api-key 도 그대로 받습니다.

쓰는 도구별 연결

[+]Claude CodeANTHROPIC_BASE_URL 두 줄이면 붙습니다

[+]Codex CLIOPENAI_BASE_URL 로 같은 방식

[+]Cursor커스텀 엔드포인트 입력란에 주소만

[+]ClineOpenAI 호환 프로바이더로 설정

에러 코드

코드	뜻	할 일
401	키가 없거나 틀림	Bearer 헤더와 키 앞 sk- 확인
402	잔액 부족	충전 후 재시도
404	경로 또는 모델 이름 오류	OpenAI 호환 경로에는 /v1 필요
429	키 단위 동시 요청 초과	지수 백오프로 재시도
5xx	상류 일시 장애	자동 재시도 후에도 계속되면 상태 확인

에러로 끝난 요청은 차감하지 않습니다.

한도·정책

[x]동시 요청60건까지 실측 확인 (155건 호출, 성공률 100%, p95 9.3초). 그 이상이 필요하면 문의하세요

[x]본문 무저장요청·응답 본문은 기록하지 않습니다. 남는 건 토큰 수·모델·시각·비용뿐입니다

[x]프롬프트 캐시공식 API 와 같은 구조. 캐시 적중분은 입력 요금의 10%

[x]추론 토큰출력 토큰으로 계산되며 사용 내역에 분리 표시됩니다

[x]선불잔액이 0 이면 402 로 멈춥니다. 미수금이 생기지 않습니다

base_url 한 줄.나머지는 그대로 둡니다.

base_url 한 줄.
나머지는 그대로 둡니다.