인증

요청은 API 키로 인증합니다. Authorization 헤더에 Bearer 토큰으로 키를 보냅니다.

Authorization: Bearer YOUR_API_KEY

키는 대시보드의 API 키 페이지에서 만듭니다. 키에 이름을 붙입니다. 사용 한도와 만료일도 설정할 수 있습니다. 잔액과 API 키 사용 한도를 참고하세요.

대시보드는 키를 만든 직후에 전체 키를 한 번만 표시합니다. 키는 cherry_로 시작합니다. 키를 잃어버렸다면 폐기하고 새 키를 만드세요. 폐기한 키는 다음 요청부터 사용할 수 없습니다.

모든 엔드포인트는 Authorization: Bearer 헤더로 키를 받습니다. Anthropic SDK가 키를 x-api-key 헤더에 담아 보내므로, POST /v1/messages 엔드포인트는 이 헤더로 보낸 키도 받습니다. 다른 엔드포인트는 x-api-key를 읽지 않습니다.

생성 엔드포인트(채팅, 이미지, 영상), 작업 엔드포인트, 잔액과 키 엔드포인트, 웹훅 엔드포인트에는 API 키가 필요합니다.

다음 엔드포인트에는 API 키가 필요하지 않습니다.

• GET /v1/models
• GET /v1/models/{vendor}/{model}
• POST /v1/estimate
• GET /v1/files/{token}: 출력 파일의 서명된 URL이 자격 증명입니다. 작업을 참고하세요.

유효한 키가 없는 요청은 코드 unauthorized와 함께 401을 반환하며, 응답에 WWW-Authenticate: Bearer 헤더가 포함됩니다. 키가 없거나, 형식이 올바르지 않거나, 존재하지 않거나, 폐기되었거나, 만료된 경우 모두 같은 오류이므로 어느 경우인지는 알 수 없습니다. 키 전체를 복사했는지 확인하고, 필요하면 새 키를 만드세요. POST /v1/messages 엔드포인트는 오류를 Anthropic 형식으로 반환합니다. 채팅을 참고하세요.

GET /v1/key 엔드포인트는 요청을 보낸 키를 반환합니다. 이름, 마지막 네 글자, 만료일, 사용 한도, 사용량을 보여 줍니다. 잔액과 API 키 사용 한도를 참고하세요.

curl "https://api.sakuranbo.ai/v1/key" \
  -H "Authorization: Bearer $SAKURANBO_API_KEY"

const response = await fetch("https://api.sakuranbo.ai/v1/key", {
  headers: {
    Authorization: `Bearer ${process.env.SAKURANBO_API_KEY}`,
  },
});
const data = await response.json();
console.log(data);

import os

import requests

response = requests.get(
    "https://api.sakuranbo.ai/v1/key",
    headers={
        "Authorization": f"Bearer {os.environ['SAKURANBO_API_KEY']}",
    },
)
print(response.json())

모든 응답에는 X-Request-Id 헤더가 포함됩니다. 자체 로그와 대조하려면 8~64자(A-Z, a-z, 0-9, _, -)의 X-Request-Id를 보내세요. 그 값이 요청 ID로 사용됩니다. 오류 응답은 error.request_id에 같은 ID를 담습니다. POST /v1/messages 엔드포인트는 오류가 Anthropic 형식이므로, 대신 최상위 request_id 필드에 ID를 담습니다.

키는 SAKURANBO_API_KEY 같은 환경 변수에 보관하세요. 클라이언트 측 코드나 공개 저장소에 넣지 마세요. POST /v1/messages 엔드포인트를 포함해 API는 서버에서 호출하세요. 브라우저는 API의 CORS 규칙이 x-api-key 헤더를 허용하지 않으므로 이 헤더를 API로 보낼 수 없습니다.

코딩 에이전트를 연결하려면 MCP 서버를 참고하세요. MCP 서버에는 API 키나 OAuth 로그인으로 연결할 수 있습니다.