Authenticatie
API keys
Inference-verzoeken authentiseren met een MartLLM API key. Keys beginnen met ull_ gevolgd door een willekeurige achtervoegsel. Geef het door als een bearer token:
Authorization: Bearer ull_your_key_here
De Anthropic-interface accepteert de key ook in de x-api-key header.
Je eerste key wordt voor je aangemaakt bij je eerste bezoek aan het dashboard en wordt daar getoond met een eerste aanroep die je kunt plakken. Maak keys aan, bewerk ze, bekijk ze en verwijder ze onder Dashboard → API Keys. Het volledige geheim wordt eenmalig getoond bij aanmaak — sla het direct op; MartLLM bewaart alleen een hash en kan het nooit meer tonen. Het verwijderen van een key (Dashboard → API Keys → Verwijderen) treedt onmiddellijk in werking: apps die het gebruiken stoppen met werken, en het eerdere gebruik ervan blijft in je totalen staan.
Besturing per sleutel
Elke sleutel kan zijn eigen beperkingen hebben, ingesteld bij het aanmaken of later met Bewerken op Dashboard → API keys. Een wijziging is van toepassing op de volgende aanvraag van de sleutel.
- Bestedingslimiet — een maximumbedrag in USD over een periode van
daily,monthlyoflifetime. Aanvragen die dit zouden overschrijden, worden geweigerd met402 key_spend_cap_exceeded. Leeg betekent geen limiet. - Dagelijkse limiet —
daily_limit_usd, bovenop de bestedingslimiet. Een aanvraag moet binnen beide passen, en de dagelijkse limiet wordt om middernacht UTC gereset. Een aanvraag die een van beide limieten overschrijdt, wordt geweigerd met402 key_spend_cap_exceededen er worden geen kosten in rekening gebracht. Stel dit in op de pagina Sleutels of metPATCH /api/v1/keys/{id}. - Frequentielimiet — een maximum aantal aanvragen per minuut (1 tot 10,000). Leeg betekent de standaardlimiet per sleutel (300 per minuut).
- Mijn aanvragen en antwoorden niet opslaan — standaard uitgeschakeld: MartLLM bewaart elke aanvraag en het bijbehorende antwoord gedurende 90 dagen om mislukte aanvragen te herstellen en ondersteuningsvragen te beantwoorden. Schakel het in en oproepen die met de sleutel zijn gedaan, worden niet opgeslagen. We bewaren alleen de registratie van elke oproep (tijd, model, aantal tokens, kosten, het adres waar het vandaan kwam, de providers die we hebben geprobeerd en eventuele fouten die zij hebben geretourneerd), niet wat u hebt verzonden of wat er terugkwam, dus we kunnen geen verkeerd antwoord voor u onderzoeken. Video- en muziekopdrachten bewaren nog steeds hun aanvraag, zodat een opdracht die een provider laat vallen opnieuw kan worden gestart. De provider die een aanvraag bedient, ontvangt deze hoe dan ook. Stel dit in op de pagina Sleutels, of met
no_store(true/false) opPOST /api/v1/keysenPATCH /api/v1/keys/{id};GET /api/v1/keysretourneert het. - BYOK provider — koppel de sleutel om via uw eigen providerreferentie te routeren (zie hieronder).
E-mail bij laag saldo
Op Dashboard → Credits kun je instellen dat je een e-mail ontvangt wanneer je saldo onder een door jou gekozen bedrag zakt. Deze functie staat standaard uit, stuurt één e-mail telkens wanneer het saldo onder dat bedrag zakt, en wordt naar de eigenaren van het account gestuurd. Als geld dat is gereserveerd voor een afbeelding-, video-, muziek- of spraakaanvraag nog steeds wordt vastgehouden 15 minuten nadat de taak is voltooid, ontvangen de accounteigenaren een e-mail met een lijst van die taken en wordt ons team hiervan op de hoogte gesteld. Dat geld is nog steeds van jou en zal worden vrijgegeven.
BYOK — breng je eigen sleutel mee
Voeg een providerreferentie toe onder Dashboard → BYOK. Verzoeken die via een BYOK-provider worden gerouteerd, gebruiken direct uw referentie; er worden geen credits gereserveerd en de kosten per token zijn nul op uw MartLLM-saldo. Opgeslagen referenties zijn versleuteld en worden alleen getoond als een gemaskeerde laatste-4.
Dashboard-sessies
U meldt zich aan bij het webdashboard met Google (één klik: de "Continue as"-prompt
op martllm.com, of de Google-knop), of met uw e-mailadres: we sturen een
6-cijferige code (en een aanmeldingslink) die binnen 15 minuten verloopt. Er is geen
wachtwoord. Bij het aanmelden wordt een kortstondige sessie aangemaakt, opgeslagen in een httpOnly cookie. Deze sessie staat los van uw
ull_ inference keys — dashboard-endpoints onder /api/v1/* gebruiken de cookie;
de gateway (/v1/*) gebruikt de API key.
Fouten
Authenticatiefouten retourneren een foutenvelop in OpenAI-stijl:
{ "error": { "code": "invalid_api_key", "message": "…", "type": "authentication_error" } }
Zie Fouten & limieten voor de volledige lijst.