플랜과 함께 API 사용하기

Dropstone API는 로그인된 화면에 의존하지 않아야 하는 코드를 위한 OpenAI 호환 엔드포인트입니다. CI 작업, 서버리스 함수, 다른 언어로 작성된 서비스 등이 해당됩니다. 키를 만들고 클라이언트를 Dropstone에 연결하면 Chat 및 CLI와 동일한 세 가지 모델을 호출할 수 있습니다.

엔드포인트 참조는 docs.dropstone.io/cli/api에서 확인할 수 있습니다. 이 페이지에서는 키, 결제, 그리고 기대할 수 있는 사항을 다룹니다.

API 키 만들기

1. 1
   대시보드에서 설정을 엽니다.
2. 2
   API 키 아래에서 키 만들기를 선택하고 이름을 지정합니다.
3. 키를 복사합니다. dsk_live_... 형식이며 한 번만 표시됩니다.

키를 비밀번호처럼 취급하세요. 절대 커밋하지 말고, 브라우저 번들에도 포함하지 마세요. 키를 가진 사람은 누구나 그 뒤에 있는 잔액을 사용할 수 있습니다. 같은 페이지에서 각 키의 마지막 사용 시점을 확인하고 언제든지 키를 취소할 수 있습니다.

결제: 종량제

주간 사용량은 로그인된 화면(Chat, CLI, 로컬 SDK 세션)에 적용됩니다. API는 별도로 측정되므로 파이프라인의 트래픽이 작업에 사용하는 사용량을 소모하지 않으며, Chat에서 바쁜 한 주가 파이프라인을 중단시키지도 않습니다. 대시보드의 결제에서 잔액을 충전하세요.

잔액이 없는 키는 요청이 거부되며, 그 사실과 충전 링크가 포함된 오류가 반환됩니다. 나중에 청구하기 위해 요청을 처리하지 않습니다. API에는 무료 티어가 없습니다.

OpenAI 호환

엔드포인트는 OpenAI 채팅 완성 형식을 따르므로, 대부분의 기존 클라이언트는 기본 URL과 키만 변경하면 작동합니다:

import OpenAI from "openai"

const openai = new OpenAI({
  baseURL: "https://api.dropstone.io/api/v1",
  apiKey: process.env.DROPSTONE_API_KEY,
})

모델은 dropstone-fast, dropstone-pro, dropstone-heavy입니다. 모델 선택을 참조하세요. HTTP 호출이 가능한 모든 언어에서 요청을 보낼 수 있습니다.

API가 지원하지 않는 기능

엔드포인트는 상태를 저장하지 않으며, 의도적으로 그렇게 설계되었습니다:

• 메모리 없음. 계정 메모리를 읽지 않으며, 답변한 내용이 거기에 기록되지도 않습니다. 지난주에 Dropstone에 가르친 내용과 관계없이 동일한 입력에는 동일한 답변이 반환됩니다.
• 도구 및 에이전트 루프 없음. 채팅 완성에만 응답합니다. 코드베이스 읽기, 파일 편집, 명령 실행은 SDK 로컬 클라이언트와 CLI의 역할입니다.

코드에서 에이전트와 그 메모리를 사용하려면 SDK의 로컬 클라이언트를 사용하세요. 모든 화면에서 하나의 메모리를 참조하세요.

속도 제한

요청은 일반적인 사용량보다 훨씬 높은 수준에서 IP별로 속도가 제한되어 서비스를 보호합니다. 제한을 초과하는 버스트는 거부되므로, 루프를 조이기보다는 백오프 후 재시도하세요.

요청이 처리되는 위치

API 요청은 다른 모든 화면과 마찬가지로 미국에서 처리됩니다. 요청이 실행되는 위치를 참조하세요.

조직

조직의 구성원은 자신의 계정 아래에서 키를 만들며, 키 뒤에 있는 잔액은 키 소유자의 것입니다. 조직 관리자는 조직 대시보드에서 구성원별 API 사용량을 확인할 수 있으며, SCIM을 통해 구성원이 제거되면 해당 계정이 비활성화되면서 키도 작동이 중지됩니다.