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 selecionadobytedance/avatar-omni-human

Página do modelo →

Campos
Nome	Tipo	Obrigatório	Padrão
image	url (image)	sim	-
audio	url (audio)	sim	-

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": "bytedance/avatar-omni-human",
  "inputs": {
    "image": "https://example.com/input.png",
    "audio": "https://example.com/input.mp3"
  }
}'

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":"bytedance/avatar-omni-human","inputs":{"image":"https://example.com/input.png","audio":"https://example.com/input.mp3"}}'

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.