API da Genlaxy: qualquer modelo a partir do seu próprio código

1 · Autenticação

Crie uma chave em Configurações, Chaves de API. Envie-a em cada requisição como token Bearer. As chaves começam com gl_live_ e funcionam apenas na Genlaxy; mantenha-as no seu servidor, nunca em um navegador ou aplicativo.

curl

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

2 · Escolha um modelo

Escolha um modelo para ver uma requisição pronta montada com os campos dele. Os campos obrigatórios já estão preenchidos e cada configuração opcional usa o padrão do modelo.

Modelo selecionadokwaivgi/kling-video-o3-4k/video-reference

Página do modelo →

Campos
Nome	Tipo	Obrigatório	Padrão
prompt	text	sim	-
video	url (video)	sim	-
images	url (image)	não	-
keep_original_sound	toggle	não	true
aspect_ratio	16:9 \| 9:16 \| 1:1	não	16:9
duration	number	não	5
element_list	json	não	-

3 · Inicie uma geração

Uma única chamada calcula o preço das suas entradas exatas e debita do seu saldo. A resposta volta na hora com o status queued e a geração roda em segundo plano. Envie um cabeçalho Idempotency-Key para que uma requisição repetida nunca cobre duas vezes.

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"
  }
}'

Confira o preço antes (opcional)

As mesmas entradas, com o preço calculado sem iniciar nada. A resposta vem em centavos.

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 · Consulte e baixe

Consulte a geração a cada poucos segundos até o status ser succeeded, failed ou refunded. Em caso de sucesso, baixe o arquivo de contentUrl com a mesma chave. Um modelo de texto retorna a resposta em 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

Endpoints

URL base: https://genlaxy.ai/api/v1/api/catalog

GET	/me	Sua chave e seu saldo
GET	/models	Todos os modelos
GET	/models/detail?id=MODEL_ID	Um modelo e seus campos
POST	/quote	Preço para entradas exatas
POST	/generations	Iniciar uma geração
GET	/generations	Suas gerações recentes
GET	/generations/ID	Status de uma geração
GET	/generations/ID/content	O arquivo de resultado
DELETE	/generations/ID	Excluir uma geração

Preços e saldo

As gerações pela API usam o mesmo saldo do estúdio e custam o mesmo. Todos os valores na API estão em centavos de euro: costCents é o que uma geração cobrou e balanceCents é o que resta.

Erros e limites

Os erros voltam em JSON com um código e uma mensagem. 401: chave ausente, incorreta ou revogada. 400: um campo é inválido (os detalhes indicam qual). 402: saldo insuficiente. 409 API_KEY_DAILY_CAP: o limite diário da chave foi atingido. 429: requisições demais, diminua o ritmo. Uma geração com falha é reembolsada automaticamente.