Genlaxy API: 모든 모델을 내 코드에서

1 · 인증

설정의 API 키에서 키를 생성하세요. 모든 요청에 Bearer 토큰으로 함께 보냅니다. 키는 gl_live_로 시작하며 Genlaxy에서만 작동합니다. 키는 서버에만 보관하고 브라우저나 앱에는 절대 넣지 마세요.

curl

curl https://genlaxy.ai/api/v1/api/catalog/me \
  -H 'Authorization: Bearer gl_live_...'

CLI로도 사용

터미널이나 코딩 에이전트를 선호하시나요? npm 패키지 genlaxy가 이 API를 감쌉니다. 설치하고 키로 로그인한 뒤 모델 ID로 어떤 모델이든 실행하세요.

curl

npm i -g genlaxy

CLI 문서 →

2 · 모델 선택

모델을 선택하면 해당 모델의 필드로 구성된 준비된 요청이 표시됩니다. 필수 필드는 채워져 있고, 선택 설정은 모두 모델의 기본값을 사용합니다.

선택한 모델openai/gpt-image-2.6-sunburst/text-to-image

모델 페이지 →

필드
이름	유형	필수	기본값
prompt	text	예	-
aspect_ratio	1:1 \| 1:2 \| 2:1 \| 1:3 \| 3:1 \| 2:3 \| ...	아니요	1:1
resolution	1k \| 2k \| 4k	아니요	1k
quality	low \| medium \| high \| xhigh \| max	아니요	medium
complexity	low \| medium \| high	아니요	high
output_format	png \| jpeg \| webp \| gif \| svg	아니요	png
frame_count	number	아니요	9
frame_duration_ms	number	아니요	200

3 · 렌더링 시작

한 번의 호출로 정확한 입력값의 가격이 책정되고 잔액에서 차감됩니다. 응답은 queued 상태로 즉시 반환되며 렌더링은 백그라운드에서 실행됩니다. Idempotency-Key 헤더를 보내면 재시도된 요청이 두 번 청구되지 않습니다.

curl

curl -X POST https://genlaxy.ai/api/v1/api/catalog/generations \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "modelId": "openai/gpt-image-2.6-sunburst/text-to-image",
  "inputs": {
    "prompt": "a lighthouse on a cliff at dusk, soft light"
  }
}'

먼저 가격 확인 (선택)

같은 입력값으로 아무것도 시작하지 않고 가격만 확인합니다. 응답은 센트 단위입니다.

curl

curl -X POST https://genlaxy.ai/api/v1/api/catalog/quote \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"modelId":"openai/gpt-image-2.6-sunburst/text-to-image","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light"}}'

4 · 폴링 및 다운로드

status가 succeeded, failed 또는 refunded가 될 때까지 몇 초 간격으로 렌더링을 조회하세요. 성공하면 같은 키로 contentUrl에서 파일을 다운로드합니다. 텍스트 모델은 대신 textOutput에 답변을 반환합니다.

curl

curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID \
  -H 'Authorization: Bearer gl_live_...'

curl

curl https://genlaxy.ai/api/v1/api/catalog/generations/GENERATION_ID/content \
  -H 'Authorization: Bearer gl_live_...' \
  -o result.png

엔드포인트

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

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	렌더링 삭제

가격과 잔액

API 렌더링은 스튜디오와 동일한 잔액을 사용하며 비용도 같습니다. API의 모든 금액은 유로 센트 단위입니다. costCents는 렌더링에 청구된 금액, balanceCents는 남은 잔액입니다.

오류와 제한

오류는 code와 message가 담긴 JSON으로 반환됩니다. 401: 키가 없거나 잘못되었거나 폐기됨. 400: 필드가 유효하지 않음 (details에 해당 필드가 명시됨). 402: 잔액 부족. 409 API_KEY_DAILY_CAP: 해당 키의 일일 한도 도달. 429: 요청이 너무 많음, 속도를 늦추세요. 실패한 렌더링은 자동으로 환불됩니다. HTML 페이지가 포함된 403: 요청이 API에 닿기 전에 차단되었습니다. 대개 User-Agent 때문입니다. Python-urllib 기본값은 차단되므로 직접 지정하세요(예: User-Agent: my-app/1.0).