개발자 · API v1

하나의 API.
모든 모델.

이미지, 동영상, 오디오, 3D를 하나의 API로. Node, Python, curl에서 호출하거나 Genlaxy CLI로 터미널에서 스크립트를 작성하세요. 모두 스튜디오와 같은 잔액에서 결제됩니다.

$npm i -g @genlaxy/cli
모델
641
엔드포인트
9
최소 충전액
€5
01 · 예제

같은 호출, 어떤 결과든

모델 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()));
예시 렌더luma/uni-v1/text-to-image
02 · 빠른 시작

세 단계로 첫 렌더

  1. 01API 키 만들기이메일로 로그인한 뒤 설정의 API 키에서 키를 만드세요. 결제에서 €5부터 충전할 수 있습니다.export GENLAXY_API_KEY="gl_live_..."
  2. 02CLI 설치명령어 하나, Node.js 18.3 이상. 설치하지 않고 아무 HTTP 클라이언트로 API를 호출해도 됩니다.npm i -g @genlaxy/cli
  3. 03첫 렌더 실행카탈로그에서 모델 ID를 고르고 프롬프트를 보내세요. --dry-run을 붙이면 비용 없이 가격만 확인합니다.genlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLI신규

터미널에서 렌더

셸, CI 작업, 코딩 에이전트에서 어떤 모델이든 실행하세요. 모든 렌더는 시작 전에 가격이 정해지고 같은 잔액에서 차감됩니다.

스크립트와 CI모델의 모든 필드가 플래그가 되고, 로컬 파일은 자동으로 업로드됩니다.
stdout으로 JSON실행마다 JSON 문서 하나, 진행 상황과 오류는 stderr로, 실패 시 0이 아닌 종료 코드.
코딩 에이전트스킬 파일이 에이전트에게 먼저 가격을 확인하고 상한을 두도록 알려 줍니다.
CLI 전체 가이드 →
명령어기능
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 사용법 가르치기
04 · API 핵심

프로덕션을 위한 설계

인증

Authorization 헤더에 Bearer 토큰. 설정에서 키를 만들고 언제든 원하는 키를 폐기할 수 있습니다.

Authorization: Bearer gl_live_...

백그라운드 렌더

렌더를 시작하면 즉시 queued 상태로 응답합니다. 성공, 실패 또는 환불될 때까지 렌더를 폴링하세요.

{ "status": "queued" }

가격 먼저

아무것도 시작하지 않고 입력값의 정확한 가격을 조회하세요. 모든 금액은 유로 센트 단위입니다.

POST /api/v1/api/catalog/quote

안전한 재시도

Idempotency-Key 헤더를 보내면 재시도한 요청이 두 번 청구되지 않습니다.

Idempotency-Key: render-042

한도

키마다 분당 한도와 선택적인 일일 상한이 있습니다. 한도를 넘으면 API가 429로 응답합니다.

429 Too Many Requests

오류와 환불

코드와 메시지가 담긴 JSON 오류. 실패한 렌더는 자동으로 잔액에 환불됩니다.

{ "status": "refunded" }
05 · 레퍼런스

엔드포인트

기본 URL https://genlaxy.ai/api/v1/api/catalog

전체 API 레퍼런스 →
GET/me내 키와 잔액
GET/models전체 모델
GET/models/detail?id=MODEL_ID모델 하나와 해당 필드
POST/quote정확한 입력값의 가격
POST/generations렌더링 시작
GET/generations최근 렌더링 목록
GET/generations/ID렌더링 하나의 상태
GET/generations/ID/content결과 파일
DELETE/generations/ID렌더링 삭제

€5 충전하고 오늘 바로 출시하세요

API, CLI, 스튜디오가 하나의 잔액을 공유합니다. 실패한 렌더는 환불됩니다.