Primeira chamada

1. Configure o ambiente

Os comandos abaixo usam Bash/zsh. Informe a chave apenas no terminal; não a adicione ao código nem a publique em um repositório.

export NEXVRA_BASE_URL='https://api.nexvra.ai/v1'
read -rs 'NEXVRA_API_KEY?API key: '
export NEXVRA_API_KEY

O comando read acima é para zsh. Em Bash, use read -rs -p 'API key: ' NEXVRA_API_KEY. Em produção, injete a chave pelo gerenciador de segredos da sua aplicação.

2. Consulte os modelos

curl --silent --show-error --fail-with-body --connect-timeout 10 --max-time 60 \
  "$NEXVRA_BASE_URL/models" \
  -H "Authorization: Bearer $NEXVRA_API_KEY"

A resposta contém object: "list" e data, com os modelos autorizados. Uma lista vazia não é um erro de autenticação: pode não haver modelo autorizado. Copie um data[].id real para NEXVRA_MODEL:

export NEXVRA_MODEL='nexvra/modelo-autorizado'

Esse ID é ilustrativo. Substitua pelo ID retornado no seu catálogo.

3. Envie uma mensagem

Requer cURL e jq. O limite de saída deve caber na política do seu modelo/projeto.

jq -n --arg model "$NEXVRA_MODEL" \
  '{model: $model, messages: [{role: "user", content: "Olá!"}], max_tokens: 128}' |
  curl --silent --show-error --fail-with-body --connect-timeout 10 --max-time 60 \
    "$NEXVRA_BASE_URL/chat/completions" \
    -H "Authorization: Bearer $NEXVRA_API_KEY" \
    -H 'Content-Type: application/json' --data-binary @-

Leia o texto em choices[0].message.content. Consulte erros se a resposta não for HTTP 200 e streaming para respostas progressivas.