Autonome Agenten-API-Schlüssel-Erstellung

​

Voraussetzungen

• Eine EVM-Wallet auf Base, die vom Agenten kontrolliert wird (Private Key in einer Umgebungsvariablen oder einem Secret Manager).
• Ein kleiner Betrag ETH auf Base für Gas (Staking sind zwei Transaktionen: approve und dann stake).
• Ein beliebiger Nicht-Null-Betrag VVV zum Staken. Der Mint-Endpoint erfordert lediglich, dass die Wallet ein Nicht-Null-sVVV-Guthaben hat, sodass 1 VVV ausreicht, um einen Schlüssel zu erstellen. Siehe Bezahlung für Inferenz für die Voraussetzungen, um bezahlte Endpoints tatsächlich aufzurufen.

​

Schritte

1

VVV erwerben

Senden Sie VVV an die Wallet des Agenten oder lassen Sie den Agenten auf einem DEX wie Aerodrome oder Uniswap tauschen.VVV-Token-Vertrag auf Base: 0xacfE6019Ed1A7Dc6f7B508C02d1b04ec88cC21bf

2

VVV bei Venice staken

Staken Sie das VVV im Venice Staking Smart Contract unter 0x321b7ff75154472B18EDb199033fF4D116F340Ff. Das sind zwei Transaktionen:

1. approve(spender, amount) auf dem VVV-Token, wobei spender der Staking-Contract ist.
2. stake(amount) auf dem Staking-Contract.

Wenn die zweite Transaktion bestätigt ist, sinkt das VVV-Guthaben der Wallet, und ihr sVVV-Guthaben steigt um denselben Betrag. Der Mint-Endpoint liest das sVVV-Guthaben, um zu bestätigen, dass die Wallet gestaked ist.

3

Ein Validierungs-Token anfordern

Rufen Sie GET /api/v1/api_keys/generate_web3_key auf, um ein kurzlebiges, von Venice signiertes Token zu erhalten. Der Endpoint ist unauthentifiziert.

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

Die Antwort enthält ein token-Feld. Das Token läuft 15 Minuten nach Ausstellung ab, also signieren und übermitteln Sie es deutlich vorher.

4

Das Token mit der Staking-Wallet signieren

Signieren Sie den rohen Token-String mit der Wallet, die das gestakte VVV hält. Dies ist ein standardmäßiger personal_sign über die Token-Bytes. Sowohl ethers.Wallet.signMessage(token) als auch account.signMessage({ message: token }) in viem erzeugen die korrekte Signatur.

5

Den API-Schlüssel erstellen

POSTen Sie die Adresse, die Signatur und das Token zusammen mit dem gewünschten Schlüsseltyp an denselben Endpoint.

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

Erforderliche Felder: address, signature, token, apiKeyType (INFERENCE oder ADMIN).Optionale Felder: description, expiresAt, consumptionLimit (begrenzt die Gesamtausgaben dieses Schlüssels, denominiert in usd, vcu oder diem).Bei Erfolg enthält die Antwort den erstellten apiKey-String. Speichern Sie ihn im Secret-Store des Agenten und verwenden Sie ihn als normales Bearer-Token (Authorization: Bearer <key>).

​

End-to-End-Beispiel

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)

​

Fehlerreferenz

​

Bezahlung für Inferenz

1. Mehr VVV staken, sodass die tägliche DIEM-Zuteilung die Ausgaben des Agenten abdeckt. Der erstellte Schlüssel verwendet dies automatisch.
2. Verwenden Sie den x402-Wallet-Flow anstelle des API-Schlüssels. Bei x402 signiert der Agent pro Anfrage eine Sign-In-With-X-Nachricht, lädt direkt mit USDC auf Base oder Solana über POST /api/v1/x402/top-up auf und bezahlt pro Anfrage. Das x402-USDC-Guthaben ist wallet-gebunden, nicht benutzerbezogen, sodass es nicht als Guthaben für den erstellten Bearer-Schlüssel angezeigt wird, aber es ermöglicht es derselben Wallet, programmatisch für Inferenz zu bezahlen.

​

Verwandte Ressourcen