REST API

Studio 플랜 전용 · Base URL https://pungnyu.14dimension.com · 인증: X-Api-Key 헤더

API 키는 앱(/app)에 로그인하면 브라우저에 발급됩니다. Studio 플랜에서 API 호출이 허용되며, 프롬프트는 서버에 저장되지 않고 생성물은 7일간 보관됩니다.

POST/api/generate

BGM/징글 생성 작업을 큐에 넣습니다. GPU가 유휴 정지 상태면 자동으로 깨어납니다(콜드 1-2분).

curl -X POST https://pungnyu.14dimension.com/api/generate \
  -H "X-Api-Key: pn_..." -H "Content-Type: application/json" \
  -d '{
    "prompt": "dark orchestral battle theme, fast strings, epic brass",
    "kind": "bgm",
    "duration": 60,
    "loop": true,
    "variations": false
  }'

필드	타입	설명
prompt	string	장르·분위기·악기 묘사 (아무 언어). 아티스트명·모사 요청은 422로 차단
preset	string?	dungeon·battle·town·field·boss·chiptune·synthwave·horror·victory·gameover
kind	string	`bgm`(15-180s) 또는 `jingle`(4-15s)
duration	int	초 단위 길이
loop	bool	심리스 루프 후처리 + loop.json 메타
variations	bool	변주 세트(기본·차분·긴장·앰비언트 4곡, Indie+)

응답: {"job":"a1b2c3d4e5f6","queued":true} · 계정당 동시 2건, Free는 월 10곡

GET/api/jobs

내 작업 목록(최근 50건)과 GPU 상태(warm/cold)를 돌려줍니다. 완료 시 files에 파일명이 담깁니다.

curl https://pungnyu.14dimension.com/api/jobs -H "X-Api-Key: pn_..."

GET/api/tracks/{job}/{file}

생성물 다운로드 — track.wav(48kHz), track.loop.json(루프 메타: sample_rate, loop_start_sec, loop_end_sec, crossfade_sec).

curl -O https://pungnyu.14dimension.com/api/tracks/a1b2c3d4e5f6/track.wav -H "X-Api-Key: pn_..."

GET/account

플랜·이번 달 사용량 조회.

루프 메타 사용법

루프 wav는 이음매가 들리지 않게 후처리되어 그대로 반복 재생하면 됩니다. Unity는 AudioSource loop=true만으로 충분하고, 구간 루프 엔진에서는 loop.json의 loop_start_sec/loop_end_sec를 사용하세요.

문의: admin@14dimension.com · llms.txt