GridPulse Favicon API

Playground

3x3 규칙 기반 패턴으로 정적/애니메이션 파비콘을 생성합니다. Avatar API와 동일하게 random / seed 호출 구조를 제공합니다.

Features

Rule Variety

이동/변형/다중점 규칙 확장 + 파라미터 제어

Deterministic Seed

같은 seed는 동일한 결과를 재생성

Multiple Formats

SVG, PNG, GIF, WebP, APNG, JSON 지원

Base URL

https://studyroom.im/api/favicon

Endpoints

GET/api/favicon/random

매 요청마다 새로운 결과를 생성합니다.

Example Request

curl "https://studyroom.im/api/favicon/random?mode=point&rule=inertia&format=webp&speed=140&trail=1&energy=8&chaos=45"
GET/api/favicon/seed/{seed}

seed 기반 결정적 결과를 생성합니다. 파라미터를 생략하면 seed만으로 규칙/색상/속도/프레임/파라미터가 자동 결정됩니다.

Path Parameters

ParameterTypeDescription
seedstring고정 키 (username, project-id, hash 등)

Example Request

curl "https://studyroom.im/api/favicon/seed/gridpulse-v2?format=webp"

With Manual Overrides

curl "https://studyroom.im/api/favicon/seed/gridpulse-v2?mode=transform&rule=kaleidoscope&format=apng&frames=24&preset=aurora"
LEGACY/api/favicon

기존 쿼리 방식도 계속 지원합니다. (seed 쿼리 포함)

curl "https://studyroom.im/api/favicon?seed=legacy-seed&mode=multi&rule=repel&format=svg"

Query Parameters

ParameterTypeDefaultDescription
modestringpointpoint | transform | multi
rulestringmode별 기본값현재 mode의 규칙명 (또는 moveRule/transformRule/multiRule)
presetstringclassicaurora | meteor | chess | duel | rainstorm
energynumber5규칙 강도 (1-9)
chaosnumber30랜덤 개입 강도 (0-100)
biasX / biasYnumber0 / 0이동 편향 (-2~2)
wrapbooleanfalse격자 경계 순환 이동
speednumber300프레임 간격(ms, 50-1200)
frames / sizenumber16 / 64프레임 수(1-60), 출력 크기(16-256)
formatstringsvgsvg | png | gif | webp | apng | json

Usage Examples

HTML

<img
  src="https://studyroom.im/api/favicon/seed/team-alpha?mode=transform&rule=kaleidoscope&format=svg"
  alt="Team Favicon"
/>

React

function ProjectIcon({ projectId }: { projectId: string }) {
  const src = "/api/favicon/seed/" + encodeURIComponent(projectId)
    + "?preset=duel&mode=multi&rule=repel&format=webp&size=96";

  return <img src={src} alt="Project icon" />;
}

cURL

# Random animated webp
curl -o gridpulse.webp "https://studyroom.im/api/favicon/random?mode=point&rule=teleport&format=webp&frames=24&trail=1"

# Deterministic JSON sequence
curl "https://studyroom.im/api/favicon/seed/sample-key?mode=multi&rule=snakeFollow&format=json&frames=20"

CORS

모든 GridPulse API 엔드포인트는 CORS가 활성화되어 외부 도메인에서 직접 호출 가능합니다.

studyroom.im