Criação autônoma de chave de API por agente

​

Pré-requisitos

• Uma carteira EVM na Base controlada pelo agente (chave privada em uma variável de ambiente ou gerenciador de segredos).
• Uma pequena quantidade de ETH na Base para gás (o staking são duas transações: approve e depois stake).
• Qualquer quantidade diferente de zero de VVV para fazer stake. O endpoint de geração exige apenas que a carteira tenha saldo de sVVV diferente de zero, então 1 VVV é suficiente para gerar uma chave. Veja Pagando pela inferência para saber o que você precisa para realmente chamar endpoints pagos.

​

Passos

1

Adquira VVV

Envie VVV para a carteira do agente, ou faça com que o agente realize um swap em uma DEX como Aerodrome ou Uniswap.Contrato do token VVV na Base: 0xacfE6019Ed1A7Dc6f7B508C02d1b04ec88cC21bf

2

Faça stake de VVV na Venice

Faça stake do VVV no Smart Contract de Staking da Venice em 0x321b7ff75154472B18EDb199033fF4D116F340Ff. São duas transações:

1. approve(spender, amount) no token VVV, onde spender é o contrato de staking.
2. stake(amount) no contrato de staking.

Quando a segunda transação for confirmada, o saldo de VVV da carteira diminui e o saldo de sVVV aumenta na mesma quantia. O endpoint de geração lê o saldo de sVVV para confirmar que a carteira está com stake.

3

Solicite um token de validação

Chame GET /api/v1/api_keys/generate_web3_key para obter um token de curta duração assinado pela Venice. O endpoint não exige autenticação.

curl --request GET \
  --url https://api.venice.ai/api/v1/api_keys/generate_web3_key

A resposta contém um campo token. O token expira 15 minutos após sua emissão, então assine e envie bem antes disso.

4

Assine o token com a carteira de stake

Assine a string bruta do token com a carteira que detém o VVV em stake. Esse é um personal_sign padrão sobre os bytes do token. Tanto ethers.Wallet.signMessage(token) quanto account.signMessage({ message: token }) do viem produzem a assinatura correta.

5

Gere a chave de API

Faça POST com o endereço, a assinatura e o token para o mesmo endpoint, junto com o tipo de chave que você quer.

curl --request POST \
  --url https://api.venice.ai/api/v1/api_keys/generate_web3_key \
  --header 'Content-Type: application/json' \
  --data '{
    "address": "<wallet address>",
    "signature": "<signed token>",
    "token": "<unsigned token>",
    "apiKeyType": "INFERENCE",
    "description": "Agent key minted on <date>"
  }'

Campos obrigatórios: address, signature, token, apiKeyType (INFERENCE ou ADMIN).Campos opcionais: description, expiresAt, consumptionLimit (limita o gasto total nessa chave, denominado em usd, vcu ou diem).Em caso de sucesso, a resposta contém a string apiKey gerada. Armazene-a no cofre de segredos do agente e use-a como um Bearer token normal (Authorization: Bearer <key>).

​

Exemplo de ponta a ponta

import { ethers } from "ethers"

const wallet = new ethers.Wallet(process.env.WALLET_PRIVATE_KEY!)
const address = wallet.address

const tokenResponse = await fetch("https://api.venice.ai/api/v1/api_keys/generate_web3_key")
const { data: { token } } = await tokenResponse.json()

const signature = await wallet.signMessage(token)

const mintResponse = await fetch("https://api.venice.ai/api/v1/api_keys/generate_web3_key", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    address,
    signature,
    token,
    apiKeyType: "INFERENCE",
    description: "Agent key",
  }),
})

const result = await mintResponse.json()
if (!mintResponse.ok) {
  throw new Error(`Mint failed: ${result.error}`)
}

console.log("Minted key:", result.data.apiKey)

​

Referência de erros

​

Pagando pela inferência

1. Fazer stake de mais VVV para que a alocação diária de DIEM cubra o gasto do agente. A chave gerada usa isso automaticamente.
2. Usar o fluxo de carteira x402 em vez da chave de API. Com o x402 o agente assina uma mensagem Sign-In-With-X por requisição, faz recarga diretamente com USDC na Base ou Solana via POST /api/v1/x402/top-up e paga por requisição. O saldo de USDC do x402 é vinculado à carteira, não ao usuário, portanto não aparece como saldo para a chave Bearer gerada, mas permite que a mesma carteira pague pela inferência programaticamente.

​

Recursos relacionados