인증
Authorization 헤더에 Bearer 토큰. 설정에서 키를 만들고 언제든 원하는 키를 폐기할 수 있습니다.
Authorization: Bearer gl_live_...이미지, 동영상, 오디오, 3D를 하나의 API로. Node, Python, curl에서 호출하거나 Genlaxy CLI로 터미널에서 스크립트를 작성하세요. 모두 스튜디오와 같은 잔액에서 결제됩니다.
npm i -g @genlaxy/cli모델 ID만 바꾸면 이미지, 동영상, 음성 사이를 전환할 수 있습니다. 필드는 모델에 따라 달라집니다.
1import { writeFile } from "node:fs/promises";2 3const API = "https://genlaxy.ai/api/v1/api/catalog";4const auth = { Authorization: `Bearer ${process.env.GENLAXY_API_KEY}` };5 6// 1. Generate an image7const res = await fetch(`${API}/generations`, {8 method: "POST",9 headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },10 body: JSON.stringify({11 modelId: "luma/uni-v1/text-to-image",12 inputs: { prompt: "Neon city street after rain, cinematic night", size: "16:9" },13 }),14});15let { generation } = await res.json();16 17// 2. Wait for the result18while (generation.status === "queued" || generation.status === "generating") {19 await new Promise((r) => setTimeout(r, 3000));20 ({ generation } = await (await fetch(`${API}/generations/${generation.id}`, { headers: auth })).json());21}22 23// 3. Save the file24const file = await fetch(`${API}/generations/${generation.id}/content`, { headers: auth });25await writeFile("result.jpeg", Buffer.from(await file.arrayBuffer()));
export GENLAXY_API_KEY="gl_live_..."npm i -g @genlaxy/cligenlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/셸, CI 작업, 코딩 에이전트에서 어떤 모델이든 실행하세요. 모든 렌더는 시작 전에 가격이 정해지고 같은 잔액에서 차감됩니다.
genlaxy loginAPI 키를 한 번만 붙여 넣으면 확인 후 저장됩니다genlaxy whoami키 이름과 내 잔액genlaxy models --type video모든 동영상 모델과 시작 가격genlaxy run <model> -h실시간으로 가져온 모델 필드: 타입, 기본값, 허용 값genlaxy run <model> -p "<prompt>" -o ./out/렌더하고 결과를 폴더에 저장genlaxy run <model> -p "..." --dry-run비용 없이 정확한 가격 확인genlaxy run <model> -p "..." --max-price 0.50가격이 더 높으면 실행 거부genlaxy run <model> -p "..." --json -o ./out/다음 단계에 바로 쓸 수 있는 JSON 결과genlaxy skill install코딩 에이전트에게 CLI 사용법 가르치기Authorization 헤더에 Bearer 토큰. 설정에서 키를 만들고 언제든 원하는 키를 폐기할 수 있습니다.
Authorization: Bearer gl_live_...렌더를 시작하면 즉시 queued 상태로 응답합니다. 성공, 실패 또는 환불될 때까지 렌더를 폴링하세요.
{ "status": "queued" }아무것도 시작하지 않고 입력값의 정확한 가격을 조회하세요. 모든 금액은 유로 센트 단위입니다.
POST /api/v1/api/catalog/quoteIdempotency-Key 헤더를 보내면 재시도한 요청이 두 번 청구되지 않습니다.
Idempotency-Key: render-042키마다 분당 한도와 선택적인 일일 상한이 있습니다. 한도를 넘으면 API가 429로 응답합니다.
429 Too Many Requests코드와 메시지가 담긴 JSON 오류. 실패한 렌더는 자동으로 잔액에 환불됩니다.
{ "status": "refunded" }/me내 키와 잔액/models전체 모델/models/detail?id=MODEL_ID모델 하나와 해당 필드/quote정확한 입력값의 가격/generations렌더링 시작/generations최근 렌더링 목록/generations/ID렌더링 하나의 상태/generations/ID/content결과 파일/generations/ID렌더링 삭제€5 충전하고 오늘 바로 출시하세요
API, CLI, 스튜디오가 하나의 잔액을 공유합니다. 실패한 렌더는 환불됩니다.