MCSKINGEN

公開ライブラリを使って開発

出典、ライセンス、取り消し可能なキーを明示したバージョン管理APIを通じて、オリジナルスキン、ブロックテクスチャ、建築設計図を読み取れます。

出典を明示した承認済み作品

スキン、テクスチャパック、建築設計図を検索し、ライセンスとクレジット表記を確認して、生成済みファイルをそのままダウンロードできます。非公開プロジェクト、元画像、プロンプト、ジョブはこのAPIの対象外です。

OpenAPI 3.1仕様をダウンロード

API v1 · 契約 1.1.0 · スコープ library:read

予測可能なリクエスト上限

各キーの上限は1分あたり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とマテリアルCSVはゲームファイルとは別です。ゲームファイルはリリース確認に合格した場合にのみ表示されます。

ブロックリソースパックには /library/textures と、返されたダウンロードURLを使用してください。各ファイルには対象ゲームのバージョンが記録されています。ファイル確認は、ゲームクライアントへのインポートを保証するものではありません。

次のページを取得するには、返されたnextCursorをcursorとして、フィルターとlimitは変更せずに送信してください。カーソルがnullなら末尾です。検索ではリテラルテキスト、ライセンス、スキンのモデルタイプを指定できます。認識できないパラメーターや重複したパラメーターは400を返します。

アクセス範囲

MCP接続と認証 →

このリリースで提供するのは、承認済み公開ライブラリの読み取りのみです。APIキーではジョブの作成、見積もりの取得、ウォレットの参照、参照画像のアップロード、キーの管理、クレジットの購入はできません。ウェブサイトのアカウントセッションでキーを別途管理します。MCPツールでは、ウェブサイトのOAuth認証を別途使用します。