# Asteon — full dokumentasjon Denne filen er en konkatenering av all offentlig markdown-dokumentasjon på asteon.ai, beregnet på LLM-er som vil dra inn alt i én bolk. Se også /llms.txt for en kort indeks. Generert: 2026-04-18T22:48:50.876Z # Asteon — forside (/) # Asteon — AI-drevet spillplattform for spillere og skapere Asteon er den nordiske spillplattformen som kombinerer AI-tjenester, lommebok-billing, multiplayer og en markedsplass for indie-skapere. Spill, skap og publiser med Asteon. ## Hovedfunksjoner - **Spillkatalog** — bla, oppdag og spill hundrevis av indie- og AI-drevne spill. Se [/browse](/browse) og [/discover](/discover). - **Game Jams** — bli med på 24 t–14 d konkurranser med tema, premie og fellesskap. Se [/jams](/jams). - **Marketplace** — kjøp og selg DLC, mods, assets og skills. Se [/marketplace](/marketplace). - **AI Gateway** — én API-nøkkel, 20+ AI-leverandører, transparent pris-margin. Se [/gateway](/gateway) og [/providers](/providers). - **Skaper-økonomi** — publiser spill, builds og skills med rettferdig payout. Se [/developers](/developers). - **Asteon Pro** — ad-fri opplevelse, tidlig tilgang og gold-badge. Se [/pro](/pro). ## For utviklere Asteon Developer Platform gir deg én konsistent API-fasade over OpenAI, Anthropic, Google, xAI, Replicate, ElevenLabs, Suno og 15+ andre — med automatisk wallet-debet og smart-routing til billigste leverandør. Kom i gang på [/docs](/docs) eller test ut [API-en interaktivt](/api-reference). ## For skapere Publiser spill, last opp builds, sett pris og se daglige salg via Creator API. Bygg plugins (Studio Skills) som AI-en kan kalle, og monetiser dem via Marketplace. Se [/developers](/developers) for full guide. ## Hvorfor Asteon - Norsk faktura med MVA, betal i din lokale valuta - Data lagres i EU (Norge & Tyskland) - Forhåndsbetalt kreditt — ingen overraskelses-regninger - Åpne specs (OpenAPI 3.1) og markdown-vennlig dokumentasjon for AI-verktøy --- # Dokumentasjon (/docs) # 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: ## 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: . Svartid hverdager innen 24 t. ### Driftsstatus Sanntidsstatus per leverandør og per region: . ### Discord-fellesskap Bli med 2 000+ utviklere på 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) --- # AI-leverandører (/providers) # AI Gateway providers Asteon proxyer 20+ AI-leverandører bak én nøkkel. Her er hva hver leverandør er spesialisert på, hvilke tjenester de tilbyr, og når du bør bruke dem. Priser vises med global margin **2×** over leverandørens råpris — innloggede brukere kan ha lavere priser via tier-rabatter. Snarveier: [Skru av/på providers](/gateway) · [API-dokumentasjon](/api-docs) ## LLM ### OpenAI **Allsidig LLM-leder med multimodale modeller.** Generelle språkmodeller, embeddings, bilder og tale. - Tjenester: GPT-4o / GPT-4o-mini chat, o-serien (resonnement), DALL·E bildegenerering, Whisper transkripsjon, TTS, text-embedding-3 - Best for: Standard chat, agenter, embeddings og når du vil ha én leverandør for alt. - Docs: ### Anthropic Claude **Sterk på lange kontekster og kodeforståelse.** Resonnement, kodegenerering og store dokument-arbeidsflyter. - Tjenester: Claude Opus / Sonnet / Haiku, Tool use, 200k+ token kontekst, Prompt caching - Best for: Kompleks resonnering, refaktorering, lange dokumenter, agent-tooling. - Docs: ### Google Gemini **Multimodal LLM med massiv kontekst.** Tekst, bilde, lyd og video i én modell. - Tjenester: Gemini 2.5 Pro / Flash, Vision-input (bilde/video), opp til 1M+ token kontekst, Embeddings - Best for: Multimodale pipelines, video-/bildeforståelse, billig høy-volum med Flash. - Docs: ### Groq **Ekstremt rask inferens på åpne modeller.** Lav-latens hosting av Llama, Mixtral, Qwen. - Tjenester: Llama 3.x, Mixtral, Qwen, Whisper STT - Best for: Sanntid-chat, taleagenter, autocomplete der hver ms teller. - Docs: ### xAI Grok **Sanntids-LLM med X-data.** Resonnement med tilgang til ferske nyheter og X/Twitter-kontekst. - Tjenester: Grok 4, Grok Vision, Real-time search - Best for: Aktuelle hendelser, sosial-media-analyse, alternativ stemme til OpenAI/Claude. - Docs: ### OpenRouter **300+ modeller bak én API.** Ruter til hvilken som helst LLM (proprietær eller åpen). - Tjenester: GPT, Claude, Gemini, Llama, Mistral, DeepSeek, Qwen …, Auto-fallback, per-modell prising - Best for: A/B-test modeller uten å bytte SDK, sjeldne modeller, fallback-strategier. - Docs: ### Moonshot Kimi **Kinesisk LLM med kjempelang kontekst.** Lange dokumenter (opptil 2M tegn) og sterk kinesisk. - Tjenester: Kimi chat, Lang-kontekst sammendrag, Web-tilkoblet variant - Best for: Asiatiske markeder, dokumentanalyse på flere hundre sider. - Docs: ### HuggingFace Inference **Hostet inferens for åpne community-modeller.** Tusenvis av åpne modeller for tekst, bilde, lyd og NLP-oppgaver. - Tjenester: Tekst-generering, klassifisering / NER / sentiment, Bilde- og lyd-modeller, Embeddings - Best for: Spesialiserte open-source-modeller (oversetting, NER, små klassifiserere). - Docs: ### Eden AI **Multi-leverandør AI-aggregator.** Én API mot OCR, oversetting, ansiktsgjenkjenning, moderering osv. - Tjenester: OCR / dokumentparsing, Oversetting (50+ språk), Bildemoderering, Tale ↔ tekst - Best for: Bedriftsfunksjoner som OCR/oversetting når du ikke vil binde deg til én leverandør. - Docs: ## Lyd & tale ### ElevenLabs **Bransjeledende AI-stemmer.** Naturtro tekst-til-tale og stemmekloning. - Tjenester: Multilingual TTS (norsk støttet), Voice cloning, Sound effects, Sanntidsstreaming - Best for: NPC-stemmer, narrator, podkast, lokalisering. - Docs: ### Suno **Generativ musikk med vokal.** Hele sanger med vokal, tekst og produksjon fra prompt. - Tjenester: Sang-generering (lyrikk + vokal), Instrumentale spor, Stemming og stilkontroll - Best for: Spillsoundtracks, jingler, dynamisk bakgrunnsmusikk. - Docs: ### Freesound **Royalty-fritt lydeffekt-bibliotek.** Søk i hundretusener av menneske-laget SFX og felt-opptak. - Tjenester: Søk og nedlasting av SFX, Lisens-metadata (CC0, CC-BY), Lignende-lyd-anbefalinger - Best for: UI-lyder, ambient, foley — gratis stoff til prototyper. - Docs: ## Bilde & video ### Replicate **Hostet kjøring av community-modeller.** Kjør hvilken som helst åpen modell (bilde, video, lyd, ML). - Tjenester: Stable Diffusion / Flux varianter, Video-modeller (AnimateDiff, SVD), LoRA fine-tunes, Custom modeller - Best for: Eksperimentere med nye åpne modeller uten egen GPU. - Docs: ### Leonardo AI **Spillorientert bildegenerering.** Konsistent karakter- og asset-design for spill. - Tjenester: Image-to-image, Karakterreferanser, Tile-bare teksturer, Element-LoRAs - Best for: Karakterportretter, item-ikoner, mood-board, sprite-grunnlag. - Docs: ### Blockade Labs **360° skybox-generering.** Equirectangular skyboxes klare for 3D-motorer. - Tjenester: Skybox fra prompt, Stilpresets (anime, fotoreal, cyberpunk …), Depth-map eksport - Best for: Bakgrunnshimler og environment maps i World Builder-scener. - Docs: ### Pixabay **Royalty-fri stockmedia.** Bilder, illustrasjoner, vektor og kort video — gratis å bruke. - Tjenester: Bildesøk, Video-søk, Musikk- og SFX-snutter - Best for: Plassholderbilder, miniatyrbilder, prototype-assets. - Docs: ## 3D ### Tripo 3D **Tekst/bilde til 3D-mesh.** Game-ready 3D-modeller fra prompt eller referansebilde. - Tjenester: Text-to-3D, Image-to-3D, Auto-rigging, PBR teksturer, GLB/FBX eksport - Best for: Props, items, byggeklosser i World Builder. - Docs: ### Meshy 3D **Tekst/bilde til 3D med animasjon.** Stilisert 3D, retopologi og innebygd animasjons-rigging. - Tjenester: Text-to-3D, Image-to-3D, Tekst-til-tekstur for eksisterende mesh, Auto-animering - Best for: Stiliserte karakterer, hurtig retopo, ferdig-animerte NPC-er. - Docs: ## Maps ### Mapbox **Kart, geokoding og navigasjon.** Vector-tiles, ruteplanlegging, tilpasset kartstil. - Tjenester: Maps GL JS, Geocoding, Directions / Matrix, Static Images - Best for: Lokasjonsbasert spill, kart-overlegg, in-world minimaps. - Docs: ### Google Maps Platform **Stedsdata med global dekning.** Places, geokoding, Street View og rikt POI-datasett. - Tjenester: Places API, Geocoding, Directions, Street View Static, Distance Matrix - Best for: Når du trenger Googles POI-database eller Street View-imagery. - Docs: ## Web ### Firecrawl **LLM-vennlig web-scraping.** Konverterer sider til ren markdown/JSON for RAG og agenter. - Tjenester: `/scrape`, `/crawl`, `/map`, Strukturert ekstraksjon med skjema - Best for: RAG-pipelines, kunnskapsbaser, konkurranse-overvåking. - Docs: --- Pris-katalogen oppdateres jevnlig. Live-priser med pris-tabell per modell og enhet ligger i React-versjonen av siden — pris er råpris × 2× margin. Faktisk kostnad logges per kall. ## Pris-katalog (sanntid) Snapshotet ble hentet 2026-04-18T10:42:46.921Z fra det offentlige katalog-endepunktet `/api/portal/providers/public`. Asteons gateway-margin er 2× over leverandørens listepris (se [/gateway](/gateway)). ### LLM - **OpenAI** (`openai`) — fra **$0.30/1M input** og $1.20/1M output (modell: `gpt-4o-mini`) — OpenAI (GPT, embeddings, images, TTS) - **Anthropic Claude** (`anthropic`) — fra **$1.60/1M input** og $8.00/1M output (modell: `claude-3-5-haiku`) — Anthropic Claude - **Google Gemini** (`google`) — fra **$0.08/1M input** og $0.30/1M output (modell: `gemini-2.5-flash-lite`) — Google AI (Gemini) - **Groq** (`groq`) — fra **$0.10/1M input** og $0.16/1M output (modell: `llama-3.1-8b-instant`) — Groq (low-latency open models) - **xAI Grok** (`xai`) — fra **$0.60/1M input** og $1.00/1M output (modell: `grok-3-mini`) — xAI (Grok) - **OpenRouter** (`openrouter`) — fra **$0.26/1M input** og $0.80/1M output (modell: `meta-llama/llama-3.3-70b`) — OpenRouter (multi-model router) - **Moonshot Kimi** (`moonshot`) — fra **$1.20/1M input** og $5.00/1M output (modell: `kimi-k2`) — Moonshot Kimi - **HuggingFace Inference** (`huggingface`) — HuggingFace Inference - **Eden AI** (`edenai`) — Eden AI (multi-provider AI router) ### Audio - **ElevenLabs** (`elevenlabs`) — fra $0.0600 per kall — ElevenLabs (text-to-speech) - **Suno** (`suno`) — fra $0.2000 per kall — Suno (music generation) - **Freesound** (`freesound`) — fra $0.0002 per kall — Freesound (royalty-free audio search) ### Image/Video - **Replicate** (`replicate`) — fra $0.1000 per kall — Replicate (image/video models) ### 3D - **Tripo 3D** (`tripo`) — fra $0.4000 per kall — Tripo 3D (text/image to 3D) - **Meshy 3D** (`meshy`) — fra $0.4000 per kall — Meshy 3D (text/image to 3D) ### Image - **Leonardo AI** (`leonardo`) — fra $0.0800 per kall — Leonardo AI (image generation) - **Blockade Labs** (`blockadelabs`) — fra $0.6000 per kall — Blockade Labs (skybox generation) - **Pixabay** (`pixabay`) — fra $0.0002 per kall — Pixabay (royalty-free images) ### Maps - **Mapbox** (`mapbox`) — fra $0.0010 per kall — Mapbox (maps, geocoding, directions) - **google-maps** (`google-maps`) — fra $0.0100 per kall — Google Maps (geocoding, places, directions, static maps) ### Web - **Firecrawl** (`firecrawl`) — fra $0.0100 per kall — Firecrawl (web scraping & crawling) --- # AI Gateway (/gateway) # AI Gateway Operativt panel for kontoens leverandørtilkoblinger. Velg hvilke leverandører din konto får lov å rute trafikk gjennom, og se forbruk siste 30 dager. Snarveier: [API-dokumentasjon](/api-docs) · [Gateway-nøkler](/settings/developer) · [Detaljert forbruk](/ai-usage) > **Krever innlogging** for å se og endre kontoens gateway-konfigurasjon. Denne siden er en operativ konsoll — for åpen leverandørkatalog og priser, se [/providers](/providers). ## Hva Gateway gjør Asteon Gateway er ett endepunkt foran 20+ AI-leverandører. Du sender en standard OpenAI-, Anthropic-, eller Google-stil request mot `https://asteon.ai/api/external//...` med en `agw_*`-nøkkel, og vi: - Veksler inn riktig leverandør-nøkkel server-side - Beregner kostnaden i USD og debiterer lommeboken din - Logger bruk per provider og per prosjekt-tag - Normaliserer feil og tilbyr smart-routing til billigste leverandør ## Per-konto innstillinger På denne siden kan du: - Skru av eller på enkeltleverandører for kontoen din - Se siste 30 dagers kall og kostnad per leverandør - Bekrefte at vi har en aktiv leverandør-nøkkel for hver tjeneste - Følge totaler for kall og kost siste 30 dager Når en leverandør er av, returnerer Gateway `404 PROVIDER_DISABLED` for kall mot den. Smart-routing hopper automatisk til neste tilgjengelige modell i klassen. ## Relaterte endepunkter - `GET /api/portal/providers` — listing for innlogget bruker (med toggles og bruk) - `GET /api/portal/providers/public` — offentlig pris-katalog (uten bruk) - `POST /api/portal/providers/{id}/toggle` — skru av/på en leverandør For full pris-tabell og leverandør-profiler, se [/providers](/providers). --- # Plugin-utvikling (/developers) # Plugin-utvikling for Asteon Builder Bygg og publiser **Studio Skills** — gjenbrukbare plugin-pakker som utvider Asteon World Builder med nye AI-verktøy, kameraoppsett, NPC-rutiner, terrengpensler, økonomi-systemer og mer. Plugins distribueres via Asteon Marketplace og installeres med ett kall. Snarveier: [Lag publish-nøkkel](/profile?tab=api) · [AI Gateway API](/api-docs) · [Bla i marketplace](/skills) · [Skaper-dashbord](/creator-dashboard) ## Tre trinn 1. **Pakk en bunt** — ett `SKILL.md` i roten + filene som verktøyet, scripts og assets ligger i. Maks 200 filer per opplasting. 2. **Publiser med API-et** — POST til `/api/skills` med en gateway-nøkkel. Bruk multipart for binærfiler eller JSON for ren tekst. 3. **Brukere installerer** — builderen henter filtreet via `/api/skills/{id}/install` og registrerer verktøyene mot AI-en. Betalte plugins trekkes fra lommeboken. ## Bunt-struktur Plugins er rene fil-trær. `SKILL.md` er den eneste obligatoriske filen. ``` my-plugin/ ├── SKILL.md # required at bundle root ├── tools/ │ ├── orbit.json # tool manifests (registered with the AI) │ └── dolly.json ├── scripts/ │ └── init.ts # runs on builder load ├── assets/ │ ├── preview-1.png │ └── ... └── README.md # optional ``` ### SKILL.md eksempel ```md --- name: cinematic-camera-pack description: Adds 6 cinematic camera presets (orbit, dolly, top-down, FPV, follow, cutscene) to the World Builder. Plug-and-play — no code required. --- # Cinematic Camera Pack Drop-in camera presets for the Asteon World Builder. ## Capabilities - Registers 6 camera tools the AI can call: `camera.orbit`, `camera.dolly`, … - Adds keybinds: `C` cycles presets, `Shift+C` resets. - Ships an `assets/` folder with 4 preview thumbnails. ## Files - `SKILL.md` (this file — required) - `tools/orbit.json`, `tools/dolly.json`, … (tool manifests) - `scripts/init.ts` (registered on builder load) - `assets/preview-*.png` ``` ## Verktøy AI-en kan kalle Plugins utvider builderen ved å registrere *tools* — JSON-skjemaer som AI-modellen kan velge å kalle. Hvert verktøy har et navn, en beskrivelse, og et JSON-Schema for parametere. Asteon Builder eksponerer 100+ innebygde verktøy gruppert i disse kategoriene: | Kategori | Eksempler på innebygde verktøy | | --- | --- | | Scene | `place_object`, `transform`, `group`, `snapshot`, `restore` | | NPC & dialog | `spawn_npc`, `set_routine`, `write_dialogue_tree`, `voice_line` | | Audio & økonomi | `place_sound_emitter`, `set_music_zone`, `define_currency`, `price_item` | | Story & terreng | `sculpt_terrain`, `paint_biome`, `place_landmark`, `write_quest_step` | | Generering & filer | `generate_image`, `generate_3d_model`, `upload_asset`, `save_to_library` | | Fysikk & kamera | `set_gravity`, `add_collider`, `configure_camera`, `animate_camera` | | Validering & registry | `validate_scene`, `register_tool`, `list_tools`, `schema_check` | ### Eksempel på et verktøy-manifest ```json { "name": "camera.orbit", "description": "Orbits the active camera around a point at constant radius.", "parameters": { "type": "object", "required": ["target"], "properties": { "target": { "type": "string", "description": "Object id or 'origin'" }, "radius": { "type": "number", "default": 8 }, "speedDegPerSec": { "type": "number", "default": 30 }, "axis": { "type": "string", "enum": ["y", "x", "z"], "default": "y" } } } } ``` ## Endepunkter | Metode | Sti | Auth | Beskrivelse | | --- | --- | --- | --- | | GET | `/api/skills` | ingen | Søk i den offentlige plugin-katalogen (filter, paginering, sortering). | | GET | `/api/skills/{id}` | ingen | Hent metadata for én plugin. | | GET | `/api/skills/by-slug/{slug}` | ingen | Slå opp plugin på unik slug. | | GET | `/api/skills/{id}/public-versions` | ingen | Liste publiserte versjoner med endringslogg. | | POST | `/api/skills` | agw_ / sesjon | Publiser ny versjon (multipart eller JSON). | | POST | `/api/skills/{id}/install` | agw_ / sesjon | Installer i kontoen din. Trekkes fra lommebok hvis betalt. | | GET | `/api/skills/mine` | agw_ / sesjon | Plugins du har publisert (med inntekt og installasjonstall). | | GET | `/api/skills/mine/timeseries` | agw_ / sesjon | Daglig tidsserie for installasjoner og inntekt. | | GET | `/api/skills/{id}/versions` | agw_ / sesjon | Alle versjoner (også draft) for en plugin du eier. | | PATCH | `/api/skills/{id}/versions/{version}` | agw_ / sesjon | Oppdater endringsnotater. | | GET | `/api/skills/{id}/versions/{version}/files` | agw_ / sesjon | Liste filer i en versjon (sti + størrelse). Kun for eier. | | POST | `/api/skills/{id}/versions/{version}/republish`| agw_ / sesjon | Re-publiser en arkivert versjon. | | PATCH | `/api/skills/{id}` | agw_ / sesjon | Endre navn, beskrivelse, kategori, pris eller status. | ## Publiser (curl) ```bash # Multipart upload (recommended for binary assets) curl -X POST https://asteon.ai/api/skills \ -H "Authorization: Bearer agw_..." \ -F "name=Cinematic Camera Pack" \ -F "slug=cinematic-camera-pack" \ -F "category=camera" \ -F "version=1.0.0" \ -F "price=0" \ -F "description=6 cinematic camera presets" \ -F "files=@SKILL.md" \ -F "files=@tools/orbit.json" \ -F "files=@scripts/init.ts" \ -F "files=@assets/preview-1.png" ``` ## Publiser (JSON) ```ts // JSON variant — file contents inline as strings const r = await fetch("https://asteon.ai/api/skills", { method: "POST", headers: { "Authorization": `Bearer ${process.env.ASTEON_GATEWAY_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ name: "Cinematic Camera Pack", slug: "cinematic-camera-pack", category: "camera", version: "1.0.1", price: 0, description: "6 cinematic camera presets", notes: "Fix orbit easing on slow framerates.", files: [ { path: "SKILL.md", content: skillMdSource }, { path: "tools/orbit.json", content: JSON.stringify(orbitTool) }, { path: "scripts/init.ts", content: initScriptSource }, ], }), }); const { id, version } = await r.json(); ``` ## Installer en plugin ```ts // Install a published plugin into the caller's account. // Skills with price > 0 are charged against the wallet on first install. await fetch(`https://asteon.ai/api/skills/${id}/install`, { method: "POST", headers: { "Authorization": `Bearer ${token}` }, }); ``` ## Versjonering & regler - **Slug** er unik. Første publisering eier sluggen — andre kan ikke ta den. - **Versjoner** bør følge SemVer (`1.2.3`). Re-publisering av samme versjon krever `overwrite=true`. - **SKILL.md** er obligatorisk i bunten — ellers avvises opplasting med `MISSING_SKILL_MD`. - **Filstier** må være relative og uten `..`. Maks ~5 MB per fil og 200 filer per opplasting. - **Status**: `draft` (skjult), `published` (synlig i marketplace), `archived` (kan installeres av eiere, ikke nye). - **Pris** i USD. 0 = gratis. Skapere får hovedandelen, plattformen tar et fast gebyr (se Skaper-dashbord for satser). - **Publish-auth**: bruk en personlig `agw_…`-nøkkel. Master-token kan ikke publisere som skaper. Trenger du eksempler? Hver innebygd plugin du installerer kan lastes ned via `/api/skills/{id}/versions/{version}/files` — bruk dem som mal. Asteons verktøy-skjema er kompatibelt med [OpenAI tool-calling](https://platform.openai.com/docs/guides/function-calling). --- # Skills marketplace (/skills) # Skills — AI-evner og verktøy Bibliotek med AI-skills og verktøy som kan plugges direkte inn i spill og agenter bygd på Asteon. Skills er gjenbrukbare plugin-pakker som utvider Asteon Builder med nye verktøy AI-modellen kan kalle. ## Hva er en skill? En **skill** er en bunt med: - En `SKILL.md`-fil med YAML-frontmatter (navn + beskrivelse) — obligatorisk - En eller flere tool-manifester (JSON-Schema) som AI-en kan kalle - Valgfrie scripts og assets AI-en leser frontmatteren for å avgjøre når skill-en er relevant, og verktøy-manifestene for å vite hva den kan kalle. ## Bla i marketplace Marketplace-en på denne siden viser alle publiserte skills med: - Navn, beskrivelse, kategori og pris - Antall installasjoner og snittvurdering - Versjonshistorikk og endringslogg - Forhåndsvisninger og preview-thumbnails Filtrer på kategori (Camera, NPC, Audio, Story, Terrain, Generation, Physics, Validation), pris (gratis vs. betalt) og popularitet. ## Installer en skill Klikk **Installer** i marketplace eller bruk API: ```ts await fetch(`https://asteon.ai/api/skills/${id}/install`, { method: "POST", headers: { "Authorization": `Bearer ${token}` }, }); ``` Betalte skills trekkes fra lommeboken din ved første installasjon. ## Publiser en skill Se [/developers](/developers) for full guide til hvordan du pakker, publiserer og tjener penger på skills. Kort versjon: 1. Lag en `SKILL.md` med navn og beskrivelse 2. Pakk verktøyene som JSON-manifester 3. POST til `/api/skills` med en `agw_*`-nøkkel 4. Sett pris > 0 for å monetisere — Asteon trekker 15 % plattformavgift ## Innebygde verktøy-kategorier Asteon Builder eksponerer 100+ innebygde verktøy gruppert i: - **Scene** — `place_object`, `transform`, `group`, `snapshot` - **NPC & dialog** — `spawn_npc`, `set_routine`, `write_dialogue_tree` - **Audio & økonomi** — `place_sound_emitter`, `set_music_zone`, `define_currency` - **Story & terreng** — `sculpt_terrain`, `paint_biome`, `write_quest_step` - **Generering & filer** — `generate_image`, `generate_3d_model`, `upload_asset` - **Fysikk & kamera** — `set_gravity`, `add_collider`, `configure_camera` - **Validering & registry** — `validate_scene`, `register_tool`, `schema_check` --- # Public API Reference (/api-reference) # Asteon API Reference Interaktiv OpenAPI 3.1-referanse for Asteon Public API (AI Gateway). Test endepunkter direkte i nettleseren. - Base-URL i produksjon: `https://asteon.ai/api` - Auth: `Authorization: Bearer agw_…` - Innholdstype: `application/json` ## Last ned spec - [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 for AI-verktøy Bruk spec-en med Postman, Insomnia, Stainless, Speakeasy eller hvilken som helst SDK-generator. ## Hva API-et dekker Public API-et eksponerer Asteon AI Gateway: - **Chat & completions** — proxy mot OpenAI, Anthropic, Google, xAI, Mistral, DeepSeek, Groq, Moonshot, OpenRouter - **Bilder, lyd, 3D, video** — Replicate, Leonardo, Meshy, Tripo, Blockade Labs, ElevenLabs, Suno - **Web/søk** — Firecrawl, Pixabay, Hugging Face - **Smart-routing** — `/api/external/smart/v1/...` velger billigste tilgjengelige leverandør - **Skills/plugins** — publiser, søk, installer - **Lommebok** — saldo, transaksjoner, påfyll - **Forbruk** — per-leverandør og per-prosjekt rapporter ## Hurtigstart ```bash curl https://asteon.ai/api/external/openai/v1/chat/completions \ -H "Authorization: Bearer agw_din_nokkel" \ -H "Content-Type: application/json" \ -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Hei!"}]}' ``` Se [/docs](/docs) for full hurtigstart, og [/providers](/providers) for pris-katalog per modell. --- # Creator API Reference (/creator-api-reference) # Creator API Reference Komplett OpenAPI-referanse for Asteon Creator API. Administrer spill, builds, salg, payouts og analyse programmatisk. - Base-URL i produksjon: `https://asteon.ai/api` - Auth: `Authorization: Bearer agc_…` (Creator API-nøkkel — generer på [/skaper/api-nokler](/skaper/api-nokler)) - Innholdstype: `application/json` ## Last ned spec - [creator-openapi.json](/creator-openapi.json) — OpenAPI 3.1 (JSON) - [creator-openapi.yaml](/creator-openapi.yaml) — OpenAPI 3.1 (YAML) - [creator-api-reference.md](/creator-api-reference.md) — Markdown-versjon for AI-verktøy ## Hva Creator API dekker - **Spill** — opprett, oppdater, publiser, arkiver - **Builds** — last opp nye builds, sett kanal (stable/beta/alpha) - **Bilder & video** — last opp screenshots, header-bilder, trailer-video - **Salg & inntekt** — daglige tall per spill, refunds, payouts - **Anmeldelser** — moderasjon, svar fra skaper - **Analyse** — wishlist, spill-tid, retention - **Marketplace-listings** — opprett/oppdater Marketplace-tilbud (DLC, assets, mods) ## Hurtigstart ```bash curl https://asteon.ai/api/creator/games \ -H "Authorization: Bearer agc_din_nokkel" ``` Se [/developers](/developers) for full guide til skaper-flyten og [/skaper/api-nokler](/skaper/api-nokler) for å lage en nøkkel. --- # Marketplace (/marketplace) # Asteon Marketplace Kjøp og selg spillinnhold på Asteon: indie-spill, DLC, mods, assets, skills og skaper-innhold. Direkte støtte til skaperne — Asteon tar et fast plattformgebyr og resten går til kreatøren. ## Hva du finner her - **Indie-spill** — fullstendige titler å kjøpe eller spille gratis - **DLC** — utvidelser og innhold til eksisterende spill - **Mods** — community-skapt innhold som utvider basisspillet - **Assets** — 3D-modeller, teksturer, lyder, musikk og animasjoner for bruk i Asteon Builder - **Skills/plugins** — gjenbrukbare AI-verktøy som utvider builderen (se [/skills](/skills)) ## Filtrer og finn - Søk på navn, sjanger, skaper eller tag - Filtrer på pris (gratis vs. betalt), kategori og popularitet - Sortér på nyeste, best vurderte, mest solgte eller billigste ## Kjøp og betaling - Betaling via Asteon-lommebok (forhåndsbetalt kreditt) eller direkte kort via Stripe - Norsk faktura med MVA der relevant - Refusjon innen 14 dager hvis innholdet ikke er brukt ## Selg ditt eget innhold For å bli skaper på Asteon Marketplace: 1. Opprett en konto og fullfør KYC (kreves for utbetaling) 2. Last opp innholdet ditt via Creator API eller via Skaper-dashbord 3. Sett pris i USD — 0 = gratis. Asteon trekker 15 % plattformavgift; resten utbetales månedlig via Stripe Connect Se [/developers](/developers) for full skaperguide og [/creator-api-reference](/creator-api-reference) for API-en. ## Aldersgrenser Innhold kan være aldersbegrenset (PEGI 7/12/16/18). Du må verifisere alder for å se eller kjøpe begrenset innhold. Skapere må sette aldersgrense ved publisering. --- # Bla gjennom spill (/browse) # Bla gjennom spill Utforsk hele Asteon-katalogen: indie-spill, AI-eksperimenter, multiplayer og singleplayer. Filtrer etter sjanger, popularitet og pris. ## Hva siden gjør Browse-siden viser alle publiserte spill på Asteon. For hvert spill ser du: - Tittel, header-bilde og kort beskrivelse - Skaper og publiseringsdato - Pris (gratis eller i USD) - Sjanger og tags - Snittvurdering og antall anmeldelser - Antall aktive spillere ## Filtrer og sortér - **Søk** på navn, sjanger eller skaper - **Filtrer** på sjanger (Action, Adventure, RPG, Strategy, Puzzle, Simulation, Sports, Casual, Indie …), pris (gratis vs. betalt), aldersgrense og plattform - **Sortér** på populært, nyeste, best vurdert, mest spilt eller billigste først Bruk Asteons AI-drevne søk på [/smart-search](/smart-search) for å beskrive hva du vil spille på naturlig norsk eller engelsk. ## Ta neste steg - [/discover](/discover) — personaliserte anbefalinger - [/jams](/jams) — bli med på en game jam - [/marketplace](/marketplace) — DLC, mods og assets - [/library](/library) — dine egne spill --- # Oppdag nye spill (/discover) # Oppdag nye spill Personaliserte spillanbefalinger drevet av AI. Finn de nyeste indie-titlene, varme jams og spill skreddersydd for din smak. ## Slik fungerer Discovery-køen Discovery-siden viser én anbefaling om gangen. For hvert spill ser du: - Stort header-bilde og kort trailer hvis tilgjengelig - Tittel, skaper, sjanger og tags - Pris og aldersgrense - Snittvurdering og antall anmeldelser Du kan: - **Spill** — start spillet med ett klikk (åpnes i nettleseren eller laster ned) - **Lik** — legg til i favoritter - **Skip** — gå til neste anbefaling - **Wishlist** — få varsel når prisen faller AI-en lærer av valgene dine og forbedrer anbefalingene fortløpende. ## Når køen er tom Når du har gått gjennom dagens kø, vises **"Queue Complete!"** og du kan gå tilbake til [/browse](/browse) for å bla i hele katalogen, eller komme tilbake i morgen for nye anbefalinger. ## Relaterte sider - [/browse](/browse) — hele katalogen - [/wishlist](/wishlist) — spill du følger med på - [/library](/library) — spill du eier - [/smart-search](/smart-search) — beskriv det du vil spille --- # Game Jams (/jams) # Game Jams — bygg spill på rekordtid Delta i Asteon Game Jams. Bygg spill alene eller i team på 24 timer til 14 dager, vinn premier og kom i kontakt med andre skapere. ## Hva er en game jam? En game jam er en tidsbegrenset konkurranse der du bygger et spill rundt et tema. Asteon arrangerer jams jevnlig, både korte (24 t / 48 t) og lange (1–2 uker), med ulike temaer og premier. ## Sider i jam-flyten - **Active Jams** — pågående jams du kan delta i nå - **Voting Open** — jams hvor innleveringene blir vurdert - **Upcoming Jams** — kommende jams du kan registrere deg til - **Past Jams** — historiske jams med vinnere og innleveringer ## For hver jam ser du - Tittel og beskrivelse - Tema og regler - Start- og sluttdato (lokal tid) - Premier - Antall deltakere og innleveringer - Snittvurdering på innleveringer (etter at voting er åpen) ## Slik deltar du 1. Klikk på en jam for å se reglene og temaet 2. Registrer deg (alene eller med team) 3. Bygg spillet i Asteon Builder eller på din egen plattform 4. Last opp innleveringen før deadline 5. Vurder andres innleveringer i voting-perioden ## Premier Topp-innleveringene vinner Asteon-kreditt, Pro-abonnement, fremhevet plassering i [/marketplace](/marketplace) eller cash-premier sponset av jam-arrangøren. ## Relaterte sider - [/browse](/browse) — bla i ferdige spill - [/developers](/developers) — bygg din første jam-innlevering - [/groups](/groups) — finn lagkamerater --- # Asteon Pro (/pro) # Asteon Pro Oppgrader til Asteon Pro for høyere AI-kvoter, eksklusive jams, prioritetsmatch-making og pro-only innhold. Fra 99 kr/mnd. Pro-abonnementet finansierer også indie-skaperne du spiller hos. ## Pro-fordeler - **Ad-Free Gaming** — Spill uten avbrytelser. Ingen annonser noe sted i plattformen. - **Early Access** — Spill nye titler først, i et eksklusivt early-access-vindu. - **Pro Badge** — Gold-badge på profil, anmeldelser og i fellesskapet. - **Support Creators** — En andel av abonnementet går direkte til indie-utviklere du spiller hos. ## Free vs Pro | Funksjon | Free | Pro | | --- | --- | --- | | Bla og spille publiserte spill | Ja | Ja | | Favoritter og spillhistorikk | Ja | Ja | | Discovery-kø | Ja | Ja | | Activity-feed | Ja | Ja | | Ad-fri opplevelse | Nei | Ja | | Tidlig tilgang til nye spill | Nei | Ja | | Gold Pro-badge | Nei | Ja | | Støtte til skapere | Nei | Ja | | Prioriterte spillanbefalinger | Nei | Ja | ## Build & Publish on Asteon For skapere finnes det egne tier-pakker (Indie, Studio, Enterprise) med høyere quotas, eksklusive jams og bedre payout-vilkår. Se Skaper-dashbord for satser, og [/developers](/developers) for utviklerflyten. ## Ofte stilte spørsmål **Hva skjer når jeg abonnerer?** Du får umiddelbar tilgang til alle Pro-funksjoner — ad-fri opplevelse, tidlig tilgang, gold-badge — og abonnementet ditt går direkte til indie-skapere du spiller hos. **Kan jeg avbryte når som helst?** Ja. Du beholder Pro ut perioden du har betalt for, og fornyelsen stopper automatisk. **Tilbyr dere refusjon?** Vi følger norsk angrerett og refunderer ubrukt periode innen 14 dager fra første kjøp. Etter det kan du avbryte når som helst. **Hva koster Pro?** Prisen vises i kassen i din lokale valuta. Norske brukere ser pris med MVA. Kontakt support hvis du trenger faktura med org.nr. --- # Hjelp og støtte (/help) # Hjelp og støtte Få svar på vanlige spørsmål, kontakt support og bla gjennom Asteon-dokumentasjonen. ## Vanlige spørsmål **Hvor finner jeg hurtigstart for utviklere?** Se [/docs](/docs) for full hurtigstart med code samples i bash, TypeScript og Python. **Hvilke AI-leverandører støttes?** 20+ leverandører — se hele katalogen med priser på [/providers](/providers). **Hvordan publiserer jeg en plugin/skill?** Se [/developers](/developers) for plugin-utviklingsguiden. **Hvor er API-referansen?** Interaktiv referanse på [/api-reference](/api-reference) (Public API) og [/creator-api-reference](/creator-api-reference) (Creator API). **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 e-post med påfyllingslenke. **Kan jeg bruke min egen leverandør-nøkkel?** Ja — under `/settings/developer` kan du legge inn BYO-nøkler. **Hvordan får jeg refusjon?** Vi følger norsk angrerett og refunderer ubrukt periode innen 14 dager fra første kjøp. ## Kontakt support - Logget inn: send melding via [/messages](/messages) - E-post: - Svartid: hverdager innen 24 t ## Driftsstatus Sanntidsstatus per leverandør og per region: ## Discord-fellesskap Bli med 2 000+ utviklere på for sanntidshjelp, release-noter og feature requests. ## Mer dokumentasjon - [/docs](/docs) — full dokumentasjon - [/providers](/providers) — pris-katalog - [/developers](/developers) — plugin/skill-utvikling - [/api-reference](/api-reference) — Public API - [/creator-api-reference](/creator-api-reference) — Creator API --- # Spillkatalog Indeks over alle 7 publiserte spill på Asteon. Hver oppføring har en egen markdown-fil under `/game/.md`. - [Idle Factory Tycoon](https://asteon.ai/game/idle-factory-tycoon) — Freemium · Idle, Simulation, Tycoon: Idle factory building and automation game - [Neon District](https://asteon.ai/game/neon-district) — Free · Action RPG, Open World, Cyberpunk: Cyberpunk open-world action RPG - [Deck of Destiny](https://asteon.ai/game/deck-of-destiny) — Free · Card Game, Strategy, Fantasy: Strategic deck-building card game - [Pixel Kingdoms](https://asteon.ai/game/pixel-kingdoms) — Pay what you want · RPG, Strategy, Fantasy: Fantasy 2D kingdom builder RPG - [Velocity Racer](https://asteon.ai/game/velocity-racer) — Free · Racing, 3D, Arcade: Fast-paced 3D racing with AI opponents - [Noir Underworld](https://asteon.ai/game/noir-underworld) — USD 9.99 · Adventure, Action RPG: Mature crime noir adventure - [Shadows of Tomorrow](https://asteon.ai/game/shadows-of-tomorrow) — USD 4.99 · Visual Novel, Sci-Fi, Narrative: Sci-fi visual novel about AI consciousness ---