OpenRouter bij Uncanny

OpenRouter geeft je met één account toegang tot de AI-modellen van andere labs dan Anthropic, het bedrijf achter Claude. Denk aan GPT van OpenAI, Gemini van Google, DeepSeek en Kimi, en aan beeld- en videomodellen zoals Nano Banana, Veo en Kling.

In Claude Code gebruik je OpenRouter via de skill openrouter. Commando's hoef je niet te kennen. Je vraagt het gewoon aan Claude. Claude kiest het model, doet de oproep en meldt wat die gekost heeft.

Elke oproep naar een model kost geld. Daarom heeft iedereen een eigen key met een eigen limiet, en gelden de afspraken op deze pagina. De korte versie staat onderaan, onder Werkfiche.

Waarvoor

Tweede mening. Laat andere modellen meekijken naar een tekst, een plan of een stuk code. Standaard vraagt Claude het aan het panel: twee sterke modellen van verschillende labs, nu GPT en Gemini, die tegelijk antwoorden. Je kan ook zelf een of meer modellen kiezen.
Bulk. Eén instructie over een hele map bestanden, zoals transcripties samenvatten, gegevens uit mails halen of documenten indelen. Claude neemt daarvoor een goedkoop en snel model, en test de instructie eerst op een of twee bestanden. De resultaten komen als bestanden op je schijf, met een manifest.json dat de kost per bestand toont. Zo blijft je gesprek met Claude licht, ook bij honderden bestanden. Stopt een run halverwege, dan gaat hij later verder waar hij stopte.
Beelden. Stills, varianten en bewerkingen op basis van een referentiebeeld, met modellen zoals Nano Banana en GPT Image.
Video. Korte clips vanuit tekst, of vanuit een eerste en een laatste beeld, met modellen zoals Veo en Kling. Op vraag komt er ook geluid bij, als het model dat kan. Een clip maken duurt een halve minuut tot enkele minuten.
Opzoekingen. Welke modellen er zijn, wat ze kosten en wat jouw key al verbruikt heeft (credits). Opzoekingen zijn gratis.

Beelden en video komen in een map openrouter-output binnen de map waarin je Claude Code geopend hebt. Naast elk bestand staat een .json-bestand met de prompt, het model, de instellingen en de kost.

Aan de slag

Toegang tot GitHub. De skill staat in de private repo uncanny-openrouter-skill van de organisatie uncanny-studio-be. Zit je in het GitHub-team Uncanny Team, dan zie je hem. Hoe je in het team komt, staat op GitHub bij Uncanny.
Clone de repo in C:/Uncanny-Claude/github, de vaste map voor alle repos van de studio. In GitHub Desktop kies je die map als Local path. In de terminal gaat het zo:
```
cd C:/Uncanny-Claude/github
git clone https://github.com/uncanny-studio-be/uncanny-openrouter-skill.git
```
Installeer de skill. Daarvoor heb je Node 18 of nieuwer nodig. Kijk het na met node --version. Heb je nog geen Node, installeer dan de LTS-versie van nodejs.org. Draai daarna het installatiescript:
```
cd C:/Uncanny-Claude/github/uncanny-openrouter-skill
node install.mjs
```
Het script kopieert de skill naar .claude/skills/openrouter in je gebruikersmap. Daar vindt Claude Code hem.
Vraag Jeff om je eigen key. Omdat iedereen een eigen key heeft, zie je het verbruik per persoon, en raakt een gelekte key maar één persoon. Bewaar de key op je eigen computer:
- Windows: open Start en zoek naar "omgevingsvariabelen voor je account". Op een Engelstalige Windows heet dat "Edit environment variables for your account". Klik onder Gebruikersvariabelen op Nieuw, vul als naam OPENROUTER_API_KEY in en plak de key als waarde. Bevestig met OK. Herstarten hoeft niet.
- Mac: zet de key in het bestand ~/.claude/openrouter.key. Open Terminal, vervang in deze regel PLAK-HIER-JE-KEY door je key en druk op Enter:
```
printf '%s' 'PLAK-HIER-JE-KEY' > ~/.claude/openrouter.key && chmod 600 ~/.claude/openrouter.key
```
  Een variabele in ~/.zshrc volstaat op een Mac niet. Apps die je vanuit het Dock opent, lezen dat bestand niet.
Plak je key nooit in een chat (ook niet met Claude), in Slack of in de vault. Gebeurt het toch, vraag Jeff dan meteen om een nieuwe key.
Test. Open een nieuw gesprek in Claude Code, want de skill laadt pas bij het begin van een gesprek. Vraag: "check mijn OpenRouter-credits". Claude toont dan wat je key al verbruikt heeft en hoeveel er van je limiet overblijft.

Lukt de test niet?

"No OpenRouter key found": Claude vindt je key niet. Kijk stap 4 na.
Fout 401: de key klopt niet of is ingetrokken. Vraag Jeff om een nieuwe.
Fout 402: je limiet of het tegoed van de studio is op. Laat het Jeff weten.

Zo vraag je het

Gewone taal volstaat. Wil je een bepaald model, noem het dan. Anders neemt Claude de standaard van de studio.

"Vraag het panel om een tweede mening over deze planning."
"Laat GPT en Gemini dit script nalezen op bugs. Hou het kort."
"Leg deze vraag voor aan Astra." Astra is het topmodel van OpenAI en kost een veelvoud van de standaard. Gebruik het voor moeilijke vragen, niet voor bulk.
"Vat elke transcriptie in deze map samen in drie bullets, met een goedkoop model. Test eerst op twee bestanden."
"Maak twee beelden van een isometrisch studiobureau in zacht ochtendlicht, in 16:9."
"Maak een video van vier seconden in 720p: een trage dolly-in op een keramische mok met opstijgende stoom."
"Welke videomodellen zijn er op OpenRouter, en wat kosten ze?"
"Check mijn OpenRouter-credits."

Afspraken

Claude volgt deze afspraken vanzelf, want ze staan in de skill. Kijk wel mee.

Klantmateriaal: eerst vragen. Wil Claude iets doorsturen dat bij een klant hoort of een klant herkenbaar maakt? Denk aan projectpagina's, mails, transcripties, briefings, leveringen en contracten. Dan zegt Claude eerst wat het wil sturen en naar welk model, en wacht het op je ja. Intern en algemeen materiaal, zoals code zonder geheimen of je eigen kladversies, mag zonder vragen. Wil je extra zekerheid, vraag dan om alleen providers die niets bijhouden (zero data retention).
Nooit geheimen. API-keys, wachtwoorden, tokens en .env-bestanden gaan nooit mee, ook niet in een bijlage. Claude haalt ze eruit. Let er zelf ook op.
Claude meldt de kost van elke oproep. Na elke betaalde oproep zegt Claude wat die gekost heeft. Na een bulkrun krijg je het totaal en de map met de resultaten.
Grote bulkruns en elke video wachten op je ja. Valt de schatting van een bulkrun boven de drempel van de studio, of vraag je een video, dan stopt Claude eerst. Je ziet het model en de geschatte kost. Pas na je duidelijke ja gaat de opdracht door. Een bulkrun stopt bovendien vanzelf aan een harde bovengrens.
Andere modellen geven een mening. Het oordeel blijft bij jou. Claude vat elk antwoord kort samen, met de naam van het model erbij. Daarna legt Claude uit waar het die mening deelt en waar het ervan afwijkt. Het volledige antwoord krijg je als je erom vraagt.

Projectwerk

Jeff heeft beslist dat beelden en video voor klantprojecten uit OpenRouter mogen komen. Daar horen deze afspraken bij.

Werk lokaal. Open Claude Code in de werkmap van het project, C:/Uncanny-Claude/work/<klant>-<project>. Claude schrijft niet op de server. Kopieer de ruwe stills zelf naar 02-assets/0200-footage/fromai-stills-initial in de projectmap, en de ruwe video naar 02-assets/0200-footage/fromai-video-initial, volgens Studio Workflow. Neem de .json-bestanden mee.
De kost gaat op het project. Het .json-bestand naast elk beeld en elke video bevat de kost. Die kost gaat als materiaal op het Teamleader-project, volgens regel 8 van Account Workflow. Het verbruik van je key toont alleen een totaal, en daarin zie je niet voor welk project het was. Gooi de .json-bestanden dus nooit weg.
Cinema Studio blijft bij Higgsfield. Voor werk in Cinema Studio blijft Higgsfield bij Uncanny de standaardroute.

Bijwerken

Bijwerken doe je in de map van de repo. Haal de laatste versie op (in GitHub Desktop met Pull origin) en draai het installatiescript opnieuw:

cd C:/Uncanny-Claude/github/uncanny-openrouter-skill
git pull
node install.mjs

Start daarna een nieuw gesprek in Claude Code.

Pas nooit de geïnstalleerde kopie in ~/.claude/skills/openrouter aan, want de volgende installatie overschrijft die. Eigen voorkeuren, zoals een ander standaardmodel, zet je in ~/.claude/openrouter.json. Dat bestand laat de installatie altijd staan.

Modellen worden snel vervangen. Meldt Claude dat een standaardmodel niet meer bestaat, dan zoekt het een opvolger. Laat het Jeff weten. Jeff past de standaard in de repo aan, en daarna werkt iedereen bij zoals hierboven.

Werkfiche

Je werkt met je eigen key. Claude doet de oproepen, en jij kijkt mee.

Eenmalig

Zorg dat je in het GitHub-team Uncanny Team zit.
Clone uncanny-openrouter-skill in C:/Uncanny-Claude/github en draai node install.mjs.
Vraag Jeff om je key. Zet hem in OPENROUTER_API_KEY (Windows) of in ~/.claude/openrouter.key (Mac).
Open een nieuw gesprek en vraag "check mijn OpenRouter-credits".

Bij elke opdracht

Klantmateriaal? Claude vraagt eerst. Kijk na wat er weggaat en naar welk model.
Geen keys, wachtwoorden of .env-bestanden in wat je meestuurt.
Lees de kost die Claude na elke oproep meldt.
Video of een grote bulkrun? Bekijk de schatting voor je ja zegt.
Een tweede mening is input. De beslissing neem je zelf.

Bij projectwerk

Werk in C:/Uncanny-Claude/work/<klant>-<project>.
Kopieer ruwe stills naar fromai-stills-initial en ruwe video naar fromai-video-initial, met de .json-bestanden erbij.
De kost uit die .json-bestanden gaat als materiaal op het Teamleader-project.
Cinema Studio-werk blijft in Higgsfield.

Bijwerken

git pull en node install.mjs in de map van de repo, daarna een nieuw gesprek.