개발자를 위한 빠른 시작 가이드

필수 조건: API 키

로그인 후 즉시 키를 생성하세요. API 키 받기 페이지를 방문하여 Google 또는 이메일 비밀번호로 인증하세요. 인터페이스는 전화번호 없이도 고유한 키를 즉시 표시합니다. 이 문자열은 기본 URL로의 모든 요청을 인증하므로 안전하게 보관하세요. 자동으로 $0.50의 체험 크레딧이 제공되며, 사용하지 않으면 7일 후 만료됩니다.

Cursor를 OpenAI 호환 가능하게 구성

클라이언트를 저희 특정 엔드포인트로 연결하여 올바른 라우팅을 보장하세요. 베이스 URL을 HTTPS://api.keyapicursor.com/v1로 설정하고 키를 Authorization 헤더에 삽입하세요. 이 구성은 모델 이름 수정 없이 모든 표준 OpenAI 호환 SDK와 함께 작동합니다. 오픈 웨이트 출력을 받기 위해 모델 식별자를 uncensored로 지정해야 합니다.

첫 요청 보내기

연결성 및 지연 시간을 확인하기 위해 간단한 완료를 실행합니다. 아래 curl 명령을 사용하여 채팅 완료 엔드포인트로 기본 프롬프트를 보내세요. 응답에는 생성된 텍스트가 포함된 JSON 객체가 반환됩니다. 사용량 필드를 확인하여 토큰 소비량이 기대치와 일치하는지 확인하세요.

ストリーミングレスポンスの処理

상호작용형 애플리케이션에서 지각된 지연 시간을 낮추기 위해 토큰을 스트리밍합니다. 서버는 최종 청크에 총 사용량 데이터가 포함될 때까지 부분 델타를 포함하는 SSE를 보냅니다. 이러한 이벤트를 구문 분석하여 UI를 실시간으로 업데이트하세요. 이 방법은 Python 및 Node 클라이언트 모두에서 동일하게 작동합니다.

Python 및 Node SDK와 통합하기

기존 코드베이스를 조정하여 기본 URL 및 키 매개변수만 변경하면 됩니다. Python 스니펫은 공식 클라이언트 라이브러리와 직접 통합하는 방법을 보여줍니다. Node 예제는 JavaScript 환경에 동일한 패턴을 따릅니다. 두 방법 모두 JSON 모드와 함수 호출을 기본적으로 지원합니다.

rate limits 및 토큰 이해하기

고부하 사용 중 서비스 중단을 피하기 위해 요청량을 모니터링하세요. 시스템은 키당 분당 300회 요청의 제한을 적용합니다. 8 MB 본문 제한으로 동시에 8개의 동시 요청을 실행할 수 있습니다. 401 유효하지 않은 키 또는 402 잔액 부족과 같은 오류는 선불 잔액을 소모하지 않습니다.

cURL

Copycurl https://api.keyapicursor.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in function parseData"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.keyapicursor.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.keyapicursor.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

스트리밍

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)