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-video-o3-4k/video-reference

モデルページ →

フィールド
名前	型	必須	既定値
prompt	text	はい	-
video	url (video)	はい	-
images	url (image)	いいえ	-
keep_original_sound	toggle	いいえ	true
aspect_ratio	16:9 \| 9:16 \| 1:1	いいえ	16:9
duration	number	いいえ	5
element_list	json	いいえ	-

3 · 生成を開始

1 回の呼び出しで入力内容に応じた価格を算出し、残高から差し引きます。レスポンスはすぐに status 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-video-o3-4k/video-reference",
  "inputs": {
    "prompt": "a lighthouse on a cliff at dusk, soft light",
    "video": "https://example.com/input.mp4"
  }
}'

先に価格を確認 (任意)

同じ入力で、何も開始せずに価格だけを算出します。結果はセント単位です。

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-video-o3-4k/video-reference","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light","video":"https://example.com/input.mp4"}}'

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	1 つのモデルとそのフィールド
POST	/quote	指定した入力の価格
POST	/generations	生成を開始
GET	/generations	最近の生成
GET	/generations/ID	1 件の生成のステータス
GET	/generations/ID/content	結果ファイル
DELETE	/generations/ID	生成を削除

価格と残高

API での生成はスタジオと同じ残高を使い、料金も同じです。API 内の金額はすべてユーロセント単位です。costCents は生成に課金された額、balanceCents は残りの残高です。

エラーと制限

エラーはコードとメッセージを含む JSON で返ります。401: キーがない、誤っている、または失効している。400: 無効なフィールドがある (詳細にフィールド名が示されます)。402: 残高不足。409 API_KEY_DAILY_CAP: キーの 1 日あたりの上限に達した。429: リクエストが多すぎるため、間隔を空けてください。失敗した生成は自動的に返金されます。