API-nycklar och agenter

Användare

En API-nyckel låter en agent eller ett skript agera som du mot AiQus API - lista köer, boka jobb, läsa vad en körning producerade - utan att logga in i webbgränssnittet.

En nyckel är inte en token

I AiQu är en token en enhet betalningskredit, vilket är vad Tokens handlar om. En API-nyckel är en credential. De har inget med varandra att göra, och ingen av dem går att spendera som den andra.

Skapa en nyckel

Öppna kontomenyn längst ned i menyn och välj API keys (den finns också under Account settings). Välj New key, ge nyckeln ett namn och en giltighetstid.

Namnet är hur du skiljer dina nycklar åt senare, så döp den efter maskinen eller agenten som ska hålla den - laptop agent, nightly retraining - snarare än efter dig själv.

Hemligheten visas en gång. AiQu lagrar bara en hash av den och kan inte visa den igen. Tappar du bort den återkallar du nyckeln och skapar en ny.

En nyckel ärver hela behörigheten hos användaren som skapade den. Den kan allt du kan, inklusive att boka jobb som spenderar krediter.

Koppla upp en agent

AiQu kör en hostad MCP-server på mcp.<din-aiqu-host>. Inget installeras lokalt: agenten kopplar upp sig över HTTPS och får en uppsättning AiQu-verktyg.

Via webbläsaren

De flesta agenter behöver bara serverns adress. Öppna kontomenyn, välj Connect an agent (finns också under Account settings) och välj din agent: Claude Code, Claude Desktop, Codex CLI, opencode, Cursor, VS Code eller Something else. Sidan visar adressen för din installation och konfigurationen för den agenten, utan någon nyckel i. För Claude Code:

claude mcp add --transport http aiqu https://mcp.aiqu.ai/mcp

Första gången agenten kopplar upp sig öppnar den AiQu i din webbläsare. Logga in om du inte redan är inloggad, så visar en godkännandesida agentens namn och adressen som godkännandet skickas till. Kontrollera den adressen: en agent kan kalla sig vad som helst, men vart godkännandet går avslöjar en bedragare.

Approve skapar en API-nyckel åt agenten, med namnet MCP: <agentens namn>, och lämnar över den utan att du någonsin ser den. Den har hela din behörighet och ingen giltighetstid, som vilken annan nyckel som helst. Den syns i din lista över API-nycklar, och återkallar du den där kopplas agenten ner.

När sidan visar en nyckel i stället

Är inloggning via webbläsaren avstängd på din installation, eller går MCP-servern inte att nå, säger Connect an agent det och hänvisar till en API-nyckel i stället.

Med en API-nyckel

CI-jobb, skript och agenter på en fjärrmaskin kan inte göra klart en inloggning i webbläsaren. Ge dem en nyckel: när du har skapat en visar sidan API keys konfigurationen för varje agent med nyckeln redan ifylld:

claude mcp add --transport http aiqu https://mcp.aiqu.ai/mcp \
  --header "Authorization: Bearer aiqu_sk_..."

Samma adress fungerar i vilken klient som helst som pratar MCP över Streamable HTTP.

Vad agenten då kan göra

whoami	Vem nyckeln tillhör, och vad den får spendera
list_queues, list_nodes, list_images	Vad som går att boka, och på vad
list_projects	Dina projekt, deras saldo, och vilket som är ditt standardprojekt
check_availability	När ett jobb av en viss form kan starta, och vad det kostar
create_job, clone_job, extend_job, cancel_job	Boka ett jobb med en eller flera tjänster, köra om ett tidigare, förlänga och avboka
list_jobs, get_job, get_job_logs	Följa det som kör
list_buckets, browse_storage, read_file	Läsa vad en körning producerade, utan att boka något
list_port_proxies, create_port_proxy, delete_port_proxy	Nå en TensorBoard eller code-server inuti ett jobb
run_in_job	Köra ett skalkommando i ett jobb som kör, som terminalen i webb-UI:t

Ett jobb håller en eller flera tjänster. Bokning, förlängning, avbokning och kostnad gäller hela jobbet, som verktygen anger med job_id. Loggar, skalet och portproxyer hör till en tjänst, som anges med service_id. list_jobs visar båda.

create_job och check_availability tar ett valfritt project_id som debiterar jobbet ett projekt, precis som projektväljaren i bokningsformuläret. På en kö som kräver projekt hamnar en bokning utan projekt på ditt standardprojekt, och avvisas om du inte har något, så be agenten anropa list_projects först.

Att boka, avboka, exponera en port och köra ett kommando i ett jobb är märkta som destruktiva, så en agent som beter sig frågar innan den gör något av det. Be din agent kontrollera tillgänglighet och berätta kostnaden innan den bokar.

Att läsa resultat kostar inget

browse_storage och read_file svarar på “vad producerade den där körningen” utan att boka ett jobb. Det är oftast frågan, och den är gratis.

Använda en nyckel direkt

Alla AiQu-endpoints tar en nyckel i stället för paret Session och Token:

curl -s https://rest.aiqu.ai/job \
  -H "Authorization: Bearer aiqu_sk_..."

Skicka nyckeln i stället för Session och Token, inte tillsammans med dem - finns en Session-header används den och nyckeln ignoreras.

Giltighetstid och återkallande

En nyckel slutar fungera när giltighetstiden passerat. Listan märker en nyckel som går ut inom sju dagar, så att du hinner byta den innan något går sönder klockan tre på natten. Nycklar skapade med Never fungerar tills de återkallas.

Återkallandet gäller omedelbart, även för en agent som är uppkopplad just nu. Återkalla en nyckel så snart du misstänker att den läckt - i en chatt, en pastebin, en commit - och skapa en ny. Det kostar ingenting att ha gjort det i onödan.

Hålla en nyckel säker

• Behandla den som ett lösenord. Den agerar som du.
• En nyckel per maskin eller agent, så att ett återkallande inte kopplar ner allt du äger.
• Committa aldrig en. Nycklar börjar med aiqu_sk_, vilket går att lära hemlighetsskannrar att leta efter.
• Föredra en giltighetstid framför Never för allt som inte är långlivad infrastruktur.