Asteon Dev Portal — Dokumentasjon

Bygg på Asteon — én Gateway, 20+ AI-leverandører, full prisinnsikt.

Hurtigstart, API-referanse, plugin-publisering og driftsstatus. Alt du trenger for å bygge spill, agenter og verktøy oppå Asteon-plattformen.

Snarveier:

Kom i gang

Asteon-API-et følger samme konvensjoner som leverandørene vi proxy-er — samme paths, samme JSON-schema, samme strømming. Du kan bytte ut api.openai.com med asteon.ai/api/external/openai uten å endre annet enn nøkkel og base-URL.

Hurtigstart

Trinn 1–2 — fra registrering til ditt første svar:

# 1. Hent en API-nøkkel fra /developers (agw_...)
# 2. Send et kall til hvilken som helst leverandør:
curl https://asteon.ai/api/external/openai/v1/chat/completions \
  -H "Authorization: Bearer agw_din_nokkel" \
  -H "X-Asteon-Project-Id: prj_din_prosjekt_uid" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hei, Asteon!"}]
  }'

Eller med OpenAI-SDK-en (Node/TypeScript):

import OpenAI from "openai";

// Pek SDK-en mot Asteon Gateway — alt annet er identisk.
const client = new OpenAI({
  apiKey: process.env.ASTEON_GATEWAY_KEY, // agw_...
  baseURL: "https://asteon.ai/api/external/openai/v1",
  defaultHeaders: {
    // Valgfri: tagg kall mot et prosjekt for forbruksrapport.
    "X-Asteon-Project-Id": process.env.ASTEON_PROJECT_ID ?? "",
  },
});

const r = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "Hei, Asteon!" }],
});
console.log(r.choices[0].message.content);

Autentisering & nøkler

Alle gateway-kall krever en agw_*-nøkkel sendt som Authorization: Bearer …. Master-nøkler er server-side og brukes kun internt; per-bruker-nøkler debiterer brukerens egen lommebok. Generer og roter nøkler under /developers.

Ditt første kall

Vi anbefaler å starte med gpt-4o-mini eller claude-3-5-haiku — begge koster mindre enn $1 per million tokens og er raske nok for de fleste bruksområder.

Tagg kall mot prosjekt

Send headeren X-Asteon-Project-Id: prj_… så bokføres kostnaden mot riktig prosjekt og dukker opp i forbruksoversikten. Du må ha rolle på prosjektet for at taggingen skal godtas.

AI Gateway

Gateway-en gir én konsistent fasade over OpenAI, Anthropic, Google, xAI, Mistral, DeepSeek, Replicate, ElevenLabs og 12+ andre — med automatisk wallet-debet, retry, og enhetlig feilformat.

Smart-routing

Bruk virtuelle modell-klasser for å la Asteon velge billigste leverandør automatisk:

// Smart-route lar deg be om en *modell-klasse* og overlate
// til Asteon å velge billigste tilgjengelige leverandør.
const r = await fetch("https://asteon.ai/api/external/smart/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.ASTEON_GATEWAY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "best-cheap-llm",   // resolves til f.eks. gpt-4o-mini, claude-haiku, gemini-flash
    messages: [{ role: "user", content: "Oppsummer dette dokumentet…" }],
  }),
});
// Asteon returnerer X-Smart-Route-Provider og X-Smart-Route-Model i headeren
// slik at du ser nøyaktig hva som ble brukt.

Streaming-svar

Sett stream: true akkurat som mot opphavsleverandøren — vi videresender SSE-strømmen uendret. Wallet-debet skjer ved siste chunk.

Feilhåndtering & retry

Alle 4xx/5xx-svar normaliseres til formen { error, code }. Smart-routing prøver automatisk neste leverandør ved 5xx eller rate-limit.

Pris-margin

Vi legger 2x på leverandørens listepris og viser begge tall i pris-katalogen. Margin finansierer plattform, drift og support.

Leverandører

Full pris-katalog per modell og enhet ligger på /providers. Kategorier vi proxy-er:

Lommebok & forbruk

Asteon kjører på forhåndsbetalt kreditt. Hvert API-kall debiteres umiddelbart fra lommeboken din etter at leverandørens svar er mottatt og kostnaden er beregnet.

Påfyll

Fyll på via Stripe under /wallet. Minimum $5, ingen utløpsdato.

Forbruk per prosjekt

/spend bryter ned forbruket ditt per leverandør og per prosjekt-tag. Bruk X-Asteon-Project-Id for å holde regnskapet rent.

Fakturaer & MVA

Vi utsteder norsk faktura med MVA der relevant. Last ned PDF-er fra /orders.

Plugin-utvikling

Pakk verktøy som skills — modulære plugins AI-en kan kalle. Publiser gratis eller mot betaling i markedsplassen. Komplett guide ligger på /developers.

SKILL.md-formatet

Hver skill har en SKILL.md med YAML-frontmatter (navn + beskrivelse) og markdown-innhold. AI-en leser frontmatteren for å vite når skill-en er relevant.

Publiser via API

POST /api/skills — multipart eller JSON. Versjonering håndteres via semver i request body.

Tjen penger på skills

Sett en pris ved publisering. Asteon trekker 15 % plattformavgift; resten utbetales månedlig via Stripe Connect. KYC kreves for utbetaling.

Hjelp & support

Ofte stilte spørsmål

Hvor lagres dataene mine? I EU (Norge & Tyskland). Vi proxy-er kun til leverandørenes nærmeste region.

Hva skjer hvis lommeboken min går tom midt i et kall? Kallet returnerer 402 Payment Required, og du får en e-post med påfyllings-lenke.

Kan jeg bruke min egen leverandør-nøkkel? Ja — under /settings/developer kan du legge inn BYO-nøkler. Da slipper du marginen, men mister smart-routing.

Er det rate-limits? Vi videresender leverandørens egne limits og legger ikke på ekstra kvoter for betalende brukere.

Kontakt support

Logget inn? Send melding via /messages. Ellers: support@asteon.ai. Svartid hverdager innen 24 t.

Driftsstatus

Sanntidsstatus per leverandør og per region: https://status.asteon.ai.

Discord-fellesskap

Bli med 2 000+ utviklere på https://discord.gg/asteon for sanntidshjelp, release-noter og feature requests.

Last ned

Hele API-et er beskrevet som OpenAPI 3.1 — last ned spec-en og bruk den med Postman, Insomnia, Stainless, Speakeasy eller hvilken som helst SDK-generator.