Creazione autonoma di API key per agenti

​

Prerequisiti

• Un wallet EVM su Base controllato dall’agente (chiave privata in una variabile d’ambiente o in un secret manager).
• Una piccola quantità di ETH su Base per il gas (lo staking richiede due transazioni: approve poi stake).
• Qualsiasi quantità non zero di VVV in staking. L’endpoint di minting richiede solo che il wallet abbia un saldo sVVV non zero, quindi 1 VVV è sufficiente per generare una chiave. Consulta Pagare l’inferenza per ciò che ti serve per chiamare effettivamente gli endpoint a pagamento.

​

Passaggi

1

Acquisisci VVV

Invia VVV al wallet dell’agente, o fai eseguire all’agente uno swap su un DEX come Aerodrome o Uniswap.Contratto del token VVV su Base: 0xacfE6019Ed1A7Dc6f7B508C02d1b04ec88cC21bf

2

Effettua lo staking di VVV con Venice

Esegui lo staking dei VVV nello smart contract di staking Venice all’indirizzo 0x321b7ff75154472B18EDb199033fF4D116F340Ff. Sono due transazioni:

1. approve(spender, amount) sul token VVV, dove spender è il contratto di staking.
2. stake(amount) sul contratto di staking.

Quando la seconda transazione viene confermata, il saldo VVV del wallet diminuisce e il suo saldo sVVV aumenta della stessa quantità. L’endpoint di minting legge il saldo sVVV per confermare che il wallet ha effettuato lo staking.

3

Richiedi un token di validazione

Chiama GET /api/v1/api_keys/generate_web3_key per ottenere un token a breve durata firmato da Venice. L’endpoint non è autenticato.

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

La risposta contiene un campo token. Il token scade 15 minuti dopo l’emissione, quindi firmalo e invialo ben prima.

4

Firma il token con il wallet di staking

Firma la stringa raw del token con il wallet che detiene i VVV in staking. Si tratta di un personal_sign standard sui byte del token. Sia ethers.Wallet.signMessage(token) sia account.signMessage({ message: token }) di viem producono la firma corretta.

5

Genera l'API key

Esegui POST con address, signature e token allo stesso endpoint, insieme al tipo di chiave che desideri.

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

Campi obbligatori: address, signature, token, apiKeyType (INFERENCE o ADMIN).Campi opzionali: description, expiresAt, consumptionLimit (limita la spesa totale su questa chiave, in usd, vcu o diem).In caso di successo, la risposta contiene la stringa apiKey generata. Conservala nel secret store dell’agente e usala come un normale Bearer token (Authorization: Bearer <key>).

​

Esempio end-to-end

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)

​

Riferimento errori

​

Pagare l’inferenza

1. Effettuare lo staking di più VVV in modo che l’allocazione giornaliera di DIEM copra la spesa dell’agente. La chiave generata lo riconosce automaticamente.
2. Usare il flusso wallet x402 al posto dell’API key. Con x402 l’agente firma un messaggio Sign-In-With-X per richiesta, ricarica direttamente con USDC su Base o Solana tramite POST /api/v1/x402/top-up e paga per richiesta. Il saldo USDC x402 è legato al wallet, non all’utente, quindi non appare come saldo per la Bearer key generata, ma consente allo stesso wallet di pagare l’inferenza in modo programmatico.

​

Risorse correlate