# 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:

- [Gateway API Reference](/api-reference)
- [Creator API Reference](/creator-api-reference)
- [Hent API-nøkkel](/developers)
- [Pris-katalog](/providers)
- [Forbruksdashbord](/spend)
- Discord: <https://discord.gg/asteon>

## 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:

```bash
# 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):

```ts
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](/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](/spend). 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:

```ts
// 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](/providers). Kategorier vi proxy-er:

- **LLM** — OpenAI, Anthropic, Google, xAI, Mistral, DeepSeek, Groq, Moonshot, OpenRouter
- **Bilde & video** — Replicate, Leonardo, Meshy, Tripo, Blockade Labs, Eden AI
- **Lyd & tale** — ElevenLabs, Suno, Freesound
- **Søk & web** — Firecrawl, Pixabay, Hugging Face

## 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](/wallet). Minimum $5, ingen utløpsdato.

### Forbruk per prosjekt

[/spend](/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](/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](/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](/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.

- [openapi.json](/openapi.json) — OpenAPI 3.1 (JSON)
- [openapi.yaml](/openapi.yaml) — OpenAPI 3.1 (YAML)
- [asteon-api-reference.md](/asteon-api-reference.md) — Markdown-versjon
- [creator-openapi.json](/creator-openapi.json) — Creator API (JSON)
- [creator-openapi.yaml](/creator-openapi.yaml) — Creator API (YAML)
- [creator-api-reference.md](/creator-api-reference.md) — Creator API (Markdown)