Dropstone Support

플랜과 함께 Dropstone API 사용하기

API 키로 HTTP를 통해 Dropstone을 호출하세요. 엔드포인트는 OpenAI 호환 방식이며, 크레딧 잔액에서 종량제로 청구되고, 모든 언어에서 작동합니다. 키, 오류, 속도 제한, 그리고 API가 제공하지 않는 기능을 다룹니다.

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

엔드포인트 참조 문서는 docs.dropstone.io/cli/api에 있습니다. 이 페이지에서는 키, 청구, 그리고 예상할 수 있는 사항을 다룹니다.

API 키 만들기

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

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

청구: 종량제

API 키 요청은 크레딧 잔액에서 종량제로 청구됩니다. 플랜 할당량은 적용되지 않습니다.

주간 할당량은 로그인된 화면, 즉 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입니다. Dropstone은 어떤 AI 모델을 사용하나요?를 참조하세요. 버전 없이 티어 이름만 지정하면 현재 라인업이 실행되므로, 스크립트는 자체적으로 라인업을 따라갑니다. 대신 버전을 고정하려면 버전이 포함된 형식(예: dropstone-fast-1.7)을 사용하세요. 모델 버전 및 월간 라인업에서 두 가지를 모두 다룹니다. 요청은 HTTP 호출이 가능한 모든 언어에서 작동합니다.

API가 제공하지 않는 기능

엔드포인트는 의도적으로 상태를 저장하지 않습니다:

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

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

속도 제한

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

요청이 처리되는 위치

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

조직

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

Related articles

Ctrl+I