๐จ JVision Bridge
์ฌ๋ด๋ง JVision Invoke AI (FLUX.2 Klein 4B) ๋ํผ โ ์บ๋ฆญํฐ ์ํธ ์ฐธ์กฐ + ๋น์จ ํ๋ฆฌ์
+ seed ์ถ์
v1.0.0
10.8.x.x VPN only
FLUX.2 Klein 4B
โ ๏ธ ์ด ํ์ด์ง๋ 10.8.x.x ๋์ญ๊ณผ 127.x์์๋ง ์ ๊ทผ ๊ฐ๋ฅ (FastAPI middleware ACL).
๐ ํต์ฌ ์ฌ์ฉ ์
curl -X POST http://10.8.0.17:8089/generate \
-H "Content-Type: application/json" \
-d '{"prompt": "haru and luna at sunset cafe", "aspect": "16:9", "characters": ["haru", "luna"]}' \
-o output.png
# ์๋ต ํค๋: X-Seed / X-Image-Name / X-Batch-Id / X-Refs / X-Size
๐ง ์๋ํฌ์ธํธ
POST/generate
์์ท ์ด๋ฏธ์ง ์์ฑ. PNG bytes ์ง์ ๋ฐํ.
Request body
| ํ๋ | ํ์
| ์ค๋ช
|
prompt | str (req) | ์์ด ๋ฌ์ฌ ๊ถ์ฅ, ์ต๋ 2000์ |
aspect | str? | ๋น์จ ํ๋ฆฌ์
(1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9) โ width/height๋ณด๋ค ์ฐ์ |
width / height | int? | aspect ์์ ๋ ์ฌ์ฉ (64~2048) |
seed | int? | ์ฌ์์ฐ์ฉ. ์์ ๋๋ ๋ฏธ์ง์ ์ ๋๋ค |
steps | int? | ๊ธฐ๋ณธ 4 (FLUX.2 Klein ๊ถ์ฅ) |
characters | list? | ['haru','luna','mori'] ์ค ์ผ๋ถ โ ํด๋น ์บ๋ฆญํฐ ์ํธ ref ์๋ ์ฒจ๋ถ (Invoke AI flux_kontext ์ฃผ์
) |
workflow | str? | ๊ธฐ๋ณธ 'flux2_klein_t2i' |
Response headers
| ํค๋ | ์ค๋ช
|
X-Seed | ์ค์ ์ฌ์ฉ๋ seed (์ฌ์์ฐ์ฉ) |
X-Image-Name | JVision ๊ฐค๋ฌ๋ฆฌ image_name (UUID) |
X-Batch-Id | ํ ๋ฐฐ์น ID |
X-Refs | ์ฒจ๋ถ๋ ref image_name (์ฝค๋ง ๊ตฌ๋ถ) |
X-Size | ์๋ต PNG ๋ฐ์ดํธ ์ |
POST/vision
์ด๋ฏธ์ง ๋น์ ๋ถ์ (multipart). jvision.ai์ gpt-v-cirtichat ๋ชจ๋ธ (Gemini ๋ฐฑ์๋) ์ฌ์ฉ. ํ๊ตญ์ด ์ค๋ช
๋ฐํ.
Form fields
| ํ๋ | ํ์
| ์ค๋ช
|
file | file (req) | ์ด๋ฏธ์ง ํ์ผ (PNG/JPG/WEBP/GIF, ์ต๋ 20MB) |
prompt | str? | ๋น์ ์ง๋ฌธ. ๊ธฐ๋ณธ "์ด ์ด๋ฏธ์ง์ ๋ฌด์์ด ๋ณด์ด๋์?" |
system | str? | system ํ๋กฌํํธ ์ค๋ฒ๋ผ์ด๋ |
max_tokens | int? | ๊ธฐ๋ณธ 500 |
curl -X POST http://10.8.0.17:8089/vision \
-F "[email protected]" \
-F "prompt=์ด ์ฌ์ง ์ ๋ถ์๊ธฐ๋ฅผ ์๋ ค์ค"
Response (JSON)
{"content":"๊ฝ๋ฐญ์์ ๊ทธ๋ฆผ ๋๊ตฌ๋ฅผ ๋ค๊ณ ์๋ ๋ค ๋ช
์ ์ธ๋ฌผ์ด ๋ณด์
๋๋ค.",
"finish_reason":"stop","model":"gpt-v-cirtichat",
"usage":{"prompt_tokens":1158,"completion_tokens":46,"total_tokens":1204,"cost":0.0003585}}
POST/vision/json
JSON body๋ก base64 ์ด๋ฏธ์ง ์ ๋ฌ. body: {image_b64, prompt?, system?, mime?, max_tokens?}. ์๋ต ํฌ๋งท์ /vision๊ณผ ๋์ผ.
POST/generate_async
๋น๋๊ธฐ โ enqueue๋ง ํ๊ณ batch_id ์ฆ์ ๋ฐํ. ๊ฒฐ๊ณผ๋ /result/{batch_id} ํด๋ง.
GET/result/{batch_id}
๋ฐฐ์น ์ํ ์กฐํ. ์๋ฃ ์ ์ฒซ ์ด๋ฏธ์ง PNG bytes ๋ฐํ, ๋ฏธ์๋ฃ ์ status JSON.
GET/aspects
์ง์ํ๋ ๋น์จ ํ๋ฆฌ์
โ width/height ๋งคํ.
{"presets":{"1:1":{"width":1024,"height":1024},"16:9":{"width":1344,"height":768},...}}
GET/refs
์บ๋ฆญํฐ ์ํธ ref ์บ์ฑ ์ํ. ์๋ ์
๋ก๋๋ image_name ๋ชฉ๋ก.
{"cached":{"haru":"3393565d-...png","luna":"a0f732a5-...png"},"supported":["haru","luna","mori"]}
POST/refs/upload/{character}
๊ฐ์ ์ฌ์
๋ก๋. character_refs/{char}.png ๊ต์ฒด ํ ํธ์ถ. ์บ์ ๋ฌดํจํ + ์ฌ์
๋ก๋.
GET/models
JVision์ install๋ ๋ชจ๋ธ ์ ์ฒด ๋ชฉ๋ก (๋ฉ์ธ / VAE / Text Encoder / LoRA).
GET/workflows
JVision์ ์ํฌํ๋ก์ฐ ๋ชฉ๋ก (default + user).
GET/healthz
ํฌ์ค ์ฒดํฌ โ JWT ๋ง๋ฃ ์๊ฐ, primary failure count ํฌํจ.
POST/auth/refresh
JWT ์ฆ์ ์ฌ๋ฐ๊ธ (๊ด๋ฆฌ์ฉ).
๐ญ ์บ๋ฆญํฐ ์ํธ ref
ํ๋กฌํํธ์ ์บ๋ฆญํฐ ํค์๋ ํฌํจ ์ jv_bridge๊ฐ ์๋์ผ๋ก ์ํธ ์ด๋ฏธ์ง๋ฅผ reference๋ก ์ฒจ๋ถ โ ์ธํ ์ผ๊ด์ฑ ํ๋ณด.
| ์บ๋ฆญํฐ | ํค์๋ |
| haru โ๏ธ | haru, ํ๋ฃจ, blonde twintails, yellow hoodie, sun mark/emblem |
| luna ๐ | luna, ๋ฃจ๋, navy hair/wavy/long, crescent moon necklace, blue knit |
| mori ๐ | mori, ๋ชจ๋ฆฌ, mint-green, heterochromia, violet and gold, card pattern hoodie |
์๋ ์นด์ดํธ๋ discordbot/image_gen.py:_detect_characters()๊ฐ ์ฒ๋ฆฌ. ์๋ ํธ์ถ ์ characters: ["haru","luna"] ๋ช
์.
๐ ํ์ผ ๋ณด๊ด
character_refs/{char}.png โ ์๋ณธ ์บ๋ฆญํฐ ์ํธ (png/jpg/webp)
character_refs/_uploaded.json โ JVision ์
๋ก๋ ํ ๋ฐ์ image_name ์บ์
workflows/flux2_klein_t2i.json โ ๊ธฐ๋ณธ t2i ์ํฌํ๋ก์ฐ ํ
ํ๋ฆฟ
๐ ACL
ํ๊ฒฝ๋ณ์ BRIDGE_ALLOWED_PREFIXES="10.8.,127." โ ์ฝค๋ง ๊ตฌ๋ถ, prefix ๋งค์นญ. ๊ทธ ์ธ ๋ชจ๋ IP๋ 403.