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 selecionadopixverse/pixverse-v4.5-t2v-fast

Página do modelo →

Campos
Nome	Tipo	Obrigatório	Padrão
prompt	text	sim	-
aspect_ratio	16:9 \| 4:3 \| 1:1 \| 3:4 \| 9:16	sim	16:9
resolution	360p \| 540p \| 720p	sim	540p
duration	5	não	5
negative_prompt	text	não	-
seed	number	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": "pixverse/pixverse-v4.5-t2v-fast",
  "inputs": {
    "prompt": "a lighthouse on a cliff at dusk, soft light",
    "aspect_ratio": "16:9",
    "resolution": "540p"
  }
}'

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":"pixverse/pixverse-v4.5-t2v-fast","inputs":{"prompt":"a lighthouse on a cliff at dusk, soft light","aspect_ratio":"16:9","resolution":"540p"}}'

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.