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。Voxel JSON 及 material CSV 與遊戲檔案分開；只有通過發佈檢查後，遊戲檔案才會顯示。

如需方塊資源包，請使用 /library/textures 及其回傳的下載網址。每個檔案都會保留其目標遊戲版本；檔案檢查不代表已確認可匯入遊戲用戶端。

如需下一頁，請將回傳的 nextCursor 作為 cursor 傳送，並保持篩選條件及 limit 不變。null cursor 表示已到最後一頁。搜尋支援一般文字、授權及皮膚手臂模型；不識別或重複的參數會回傳 400。

存取界限

MCP 連線與授權 →

此版本僅開放讀取已核准的公開資料庫內容。API 金鑰不可建立工作、取得報價、讀取錢包、上載參考資料、管理金鑰或購買點數。網站帳戶工作階段會獨立管理金鑰。MCP 工具使用獨立的網站 OAuth 授權。