v3.1.0Configuration Guide

🔑 API-Keys Konfiguration

Diese Anleitung zeigt dir, wie du API-Keys für LLM-Features und andere externe Services in VelinScript konfigurierst.

Schnellstart: Umgebungsvariablen

Der sicherste Weg, Keys lokal zu verwalten, sind Umgebungsvariablen.

Windows (PowerShell)

$env:OPENAI_API_KEY = "sk-..."
$env:ANTHROPIC_API_KEY = "sk-ant-..."
$env:GOOGLE_GEMINI_API_KEY = "AIza..."

Linux/Mac

export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GOOGLE_GEMINI_API_KEY="AIza..."

In Code verwenden

fn getApiKey(): string {
    // Nutze config.get_env() für Umgebungsvariablen
    return config.get_env("OPENAI_API_KEY", "");
}

@POST("/api/chat")
fn chat(message: string): string {
    let llm = LLMClient.new("openai", getApiKey());
    let result = await llm.generate(message);
    return result;
}

Verfügbare API-Keys & Provider

OpenAI

Portal

Variable: OPENAI_API_KEY

Format: sk-...

Anthropic Claude

Portal

Variable: ANTHROPIC_API_KEY

Format: sk-ant-...

Google Gemini

Portal

Variable: GOOGLE_GEMINI_API_KEY

Format: AIza...

Vector DBs

Pinecone: PINECONE_API_KEY

Weaviate: WEAVIATE_API_KEY

Konfiguration über velin.config.json

Zentralisiere deine KI-Einstellungen in einer Projektdatei.

{
  "ml": {
    "llm": {
      "provider": "openai",
      "apiKey": "${OPENAI_API_KEY}",
      "anthropicApiKey": "${ANTHROPIC_API_KEY}",
      "geminiApiKey": "${GOOGLE_GEMINI_API_KEY}",
      "model": "gpt-4"
    }
  }
}

Sicherheits-Best-Practices

No Hardcoding

API-Keys niemals als Strings direkt im Quellcode speichern.

Gitignore

Stelle sicher, dass .env und velin.config.json nicht committet werden.

Key Rotation

Tausche Keys regelmäßig aus, besonders nach Team-Wechseln.

Least Privilege

Nutze Keys mit eingeschränkten Rechten für Production-Systeme.

🧪 Testing ohne API-Keys

Für lokale Tests kannst du den local Provider verwenden, um Antworten zu simulieren.

let llm = LLMClient.new("local", "");
return await llm.generate("Hallo Welt");