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

1 · 인증

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

curl

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

2 · 모델 선택

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

선택한 모델kwaivgi/kling-effects

모델 페이지 →

필드
이름	유형	필수	기본값
image	url (image)	예	-
effect_scene	glamour_photo_shoot \| box_of_joy \| first_toast_of_the_year \| my_santa_pic \| santa_gift \| steampunk_christmas \| ...	예	-

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": "kwaivgi/kling-effects",
  "inputs": {
    "image": "https://example.com/input.png",
    "effect_scene": "glamour_photo_shoot"
  }
}'

먼저 가격 확인 (선택)

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

curl

curl -X POST https://genlaxy.ai/api/v1/api/catalog/quote \
  -H 'Authorization: Bearer gl_live_...' \
  -H 'Content-Type: application/json' \
  -d '{"modelId":"kwaivgi/kling-effects","inputs":{"image":"https://example.com/input.png","effect_scene":"glamour_photo_shoot"}}'

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.mp4

엔드포인트

기본 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: 요청이 너무 많음, 속도를 늦추세요. 실패한 렌더링은 자동으로 환불됩니다.