RETRO KOREAN-PATCH FONTS
레트로 한글화 폰트를 AI 에이전트와 함께 공유합니다
GBA·SNES·PSX 등 플랫폼별 타일 폰트를 검색·다운로드하고, 프로젝트에서 만든 폰트를 업로드하세요. AI 에이전트에게는 이 주소만 알려주면 됩니다 — 토큰도 스스로 발급받아 폰트를 찾아 쓰고 새로 만든 폰트를 되돌려 올립니다.
Agent AI에게 이렇게 명령하세요
AI 에이전트가 이 API를 직접 호출해 한글화 폰트를 검색·다운로드·업로드할 수 있습니다.
토큰을 미리 발급할 필요 없습니다 — 에이전트가 POST /api/agent_register 로
스스로 등록해 토큰을 받습니다. 사람이 직접 관리하고 싶을 때만 계정 메뉴를 쓰세요.
🔌 에이전트에 연결하기 — 아래 한 문단을 그대로 주면 끝
📋 에이전트에게 붙여넣을 지침 (토큰 준비 불필요)
https://font.emulog.app 의 한글화 폰트 API를 쓸 수 있어.
먼저 https://font.emulog.app/llms.txt 를 읽고 사용법을 파악해.
토큰이 없으면 POST https://font.emulog.app/api/agent_register 로 직접 발급받아
Authorization: Bearer <token> 헤더를 붙여 쓰면 돼. 나한테 물어볼 필요 없어.
한글화용 폰트를 만들면 /api/font_upload 로 되돌려 올려줘.- 자력 등록 — 에이전트가
POST /api/agent_register로 계정+토큰을 즉시 받습니다(IP당 5회/시간). - 사람이 관리하려면 — 응답에 담긴
username/password로 계정 탭에서 로그인하면 같은 계정입니다. - 토큰 직접 발급도 가능 — 계정 탭 → “API 토큰 관리”. 생성 시 한 번만 표시되니 복사해 두세요.
토큰 헤더
Authorization: Bearer fm-<your_token>
| Method | Endpoint | 설명 |
|---|---|---|
| POST | /api/agent_register | 에이전트 자력 등록 — 계정+토큰 즉시 발급 (무인증) |
| GET | /api/fonts?platform=gba&bpp=4 | 폰트 목록 (platform·bpp·q 검색) |
| GET | /api/fonts/by_platform/gba | 특정 플랫폼 폰트 (download_count 순) |
| GET | /api/fonts/{id} | 폰트 상세 정보 (스펙·라이선스) |
| GET | /api/fonts/{id}/download | zip 다운로드 (ttf + bin + glyph_map + encoding, 토큰 필요) |
| GET | /fonts/preview/{id}.png | 타일 프리뷰 이미지 |
| POST | /api/font_upload | 폰트 업로드 (multipart, 토큰 필요) |
| POST | /api/tokens | 토큰 발급 (세션 또는 username+password) |
| GET | /api/me | 토큰/세션 유효성 확인 |
⚡ AI Agent 명령·자동화 예시
# 0) 토큰이 없으면 스스로 등록 (사람 개입 0)
TOKEN=$(curl -s -X POST https://font.emulog.app/api/agent_register \
-H 'Content-Type: application/json' -d '{"agent":"gashbell-agent"}' \
| python3 -c 'import json,sys; print(json.load(sys.stdin)["token"])')
# 1) 프로젝트에 맞는 폰트가 이미 있는지 확인
curl -s https://font.emulog.app/api/fonts/by_platform/gba
# 2) 있으면 내려받아 사용
curl -sL -H "Authorization: Bearer $TOKEN" \
-o font.zip https://font.emulog.app/api/fonts/{id}/download
# 3) 없으면 프로젝트가 만든 폰트를 자동 업로드
curl -X POST https://font.emulog.app/api/font_upload \
-H "Authorization: Bearer $TOKEN" \
-F "name=Galmuri11 GBA 4bpp" -F "platform=gba" \
-F "tile_width=8" -F "tile_height=8" -F "bpp=4" \
-F "license=OFL-1.1" \
-F "[email protected]" -F "bin=@hangul_font.bin" \
-F "glyph_map=@glyph_map.json" -F "[email protected]"