MCSKINGEN

공개 라이브러리로 개발하기

출처와 라이선스가 명시된 오리지널 스킨, 블록 텍스처, 건축 설계도를 버전 관리 API와 철회 가능한 키로 조회하세요.

출처가 명시된 승인 작품

스킨, 텍스처 팩, 건축 설계도를 검색하고 라이선스와 저작자 표시 정보를 확인한 다음, 생성된 파일을 그대로 다운로드하세요. 비공개 프로젝트, 원본 이미지, 프롬프트, 작업은 이 API의 제공 범위에 포함되지 않습니다.

OpenAPI 3.1 명세 다운로드

API v1 · 계약 1.1.0 · 범위 library:read

예측 가능한 요청 할당량

각 키는 분당 60회, UTC 기준 하루 5000회의 요청을 허용합니다. 이 요청은 생성 크레딧을 사용하지 않습니다. 응답 헤더에서 남은 할당량을 확인하고, 429 응답 시 Retry-After를 준수하세요.

ETag와 If-None-Match를 사용해 캐시하세요. 재검증 시 304를 반환하기 전에 키와 현재 공개 상태를 확인합니다. 공개가 철회된 콘텐츠는 404를, 철회되거나 만료된 키는 401을 반환합니다.

읽기 전용 키 만들기

웹사이트 계정으로 로그인하여 연동 키를 생성하고 확인하거나 철회하세요.

조회, 확인, 다운로드

신뢰할 수 있는 서버 설정 파일에 키를 보관하세요. Authorization 헤더로 키를 전송하세요. 작품을 표시하거나 재배포할 때는 sourceUrl, author, license와 상속된 저작자 표시 정보를 유지하세요. 비영리 라이선스의 비영리 제한은 그대로 적용됩니다.

# 1. 승인된 스킨 검색
curl 'https://mcskingen.com/api/v1/library/skins?limit=2&model=classic' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY'

# 2. 반환된 ID로 발행물 읽기
curl 'https://mcskingen.com/api/v1/library/skins/PUBLICATION_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY'

# 3. 반환된 에셋 중 하나 다운로드
curl 'https://mcskingen.com/api/v1/assets/ASSET_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY' \
  --output original-skin.png

건축 구조물에는 /library/buildings?category=houses를 사용하세요. 복셀 JSON과 재료 CSV는 게임 파일과 별개이며, 게임 파일은 출시 검사를 통과한 후에만 제공됩니다.

블록 리소스 팩에는 /library/textures와 해당 응답으로 반환된 다운로드 URL을 사용하세요. 각 파일의 대상 게임 버전은 그대로 유지됩니다. 파일 검사가 게임 클라이언트로 가져오기를 보증하지는 않습니다.

다음 페이지를 요청하려면 필터와 limit을 변경하지 않고, 반환된 nextCursor를 cursor로 전송하세요. cursor가 null이면 마지막 페이지입니다. 검색은 리터럴 텍스트, 라이선스, 스킨 팔 모델을 지원합니다. 인식할 수 없거나 중복된 매개변수는 400을 반환합니다.

접근 범위 제한

MCP 연결 및 승인 →

이번 릴리스는 승인된 공개 라이브러리의 읽기 기능만 제공합니다. API 키로는 작업 생성, 견적 요청, 지갑 조회, 참조 자료 업로드, 키 관리, 크레딧 구매를 할 수 없습니다. 키 관리는 별도의 웹사이트 계정 세션에서 수행합니다. MCP 도구는 별도의 웹사이트 OAuth 승인을 사용합니다.