NL ▾
API-sleutel ophalen

kimiapikey.comGids

Moonshot API Base URL: wijzig het doel van je code

De moonshot api base url is slechts één tekenreeks in je OpenAI-style client, en het wijzigen ervan is hoe je dezelfde code naar een andere provider stuurt. Deze pagina laat zien waar die tekenreeks zich bevindt in Python, Node, curl en veelgebruikte tools, en hoe je hem op een alternatief endpoint kunt richten.

Bijgewerkt

Een kabel die tussen twee stopcontacten op een schakelpaneel wordt verplaatst, ter illustratie van een gewijzigde base URL
Isometrische illustratie van een code-editor die via een gloeiende kabel is verbonden met een API-server

Belangrijkste punten

  • De base URL is een enkele instelling; de request body blijft in het OpenAI chat-formaat.
  • Wijzig drie dingen als je van provider wisselt: base URL, API-sleutel, model ID.
  • Ons endpoint is https://api.kimiapikey.com/v1 en de model ID is uncensored.
  • Het is een onafhankelijk gehost model, geen officiële service van Moonshot, dus test je prompts opnieuw.

Wat een base URL precies doet

OpenAI-compatible clients bouwen elk verzoek uit twee delen: een base URL en een pad. De SDK voegt ze samen, dus een aanroep van chat.completions.create wordt een POST naar <base_url>/chat/completions. Providers die dit formaat volgen, zoals Moonshot, publiceren hun eigen base URL in hun documentatie. Zoek het daar op in plaats van het van een forumpost te kopiëren, want het is de enige waarde die je niet kunt raden.

Het wisselen van provider vereist daarom drie aanpassingen en niets anders:

  1. De base URL, die bepaalt waar het verzoek naartoe gaat.
  2. De API-sleutel, die per provider wordt uitgegeven en alleen werkt op de servers van die provider.
  3. De model ID, omdat elke provider zijn modellen anders noemt.

Berichten, rollen, streaming, tools en JSON-modus behouden dezelfde structuur, waardoor de migratie kort is. Alles wat afhankelijk is van een provider-specifieke functie, zoals een ingebouwde webzoektool, vereist aparte afhandeling.

Het helpt ook om de drie waarden samen te houden in één configuratieblok of één omgevingsbestand per provider. Als de base URL, sleutel en model ID naast elkaar staan, is terugschakelen een eenregelige wijziging en voorkom je de halfgemigreerde staat waarin een nieuwe sleutel is gekoppeld aan een oud adres.

Python: het openai package

In Python stel je de base URL in wanneer je de client aanmaakt. Dit voorbeeld communiceert met het endpoint op deze site:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.kimiapikey.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)

Als je de code liever vrij wilt houden van instellingen, gebruik dan de omgeving. De SDK leest OPENAI_BASE_URL en OPENAI_API_KEY wanneer je OpenAI() aanroept zonder argumenten, zodat je bij een implementatie van provider kunt wisselen zonder code-aanpassing. Houd er rekening mee dat dit ook betekent dat een achtergebleven variabele in je shell een waarde in het bestand kan overschrijven.

Node en curl

Het officiële JavaScript-pakket gebruikt dezelfde optienaam, geschreven in camel case:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.kimiapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Hello" }],
  stream: false,
});
console.log(resp.choices[0].message.content);

Zonder SDK is de base URL gewoon het voorvoegsel van het adres:

curl https://api.kimiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'

Dit endpoint accepteert ook POST /v1/responses, en GET /v1/models geeft aan wat het aanbiedt. Authenticatie is een Bearer token in de Authorization header in elk geval.

Editors en chatfrontends

GUI-tools stellen de base URL voor onder verschillende labels: "API base", "Override OpenAI Base URL", "Custom endpoint" of "Provider URL". De waarde die je plakt is dezelfde tekenreeks als in de code hierboven, eindigend op /v1. Plak niet het volledige /chat/completions adres tenzij de tool zegt dat het volledige URL nodig heeft.

Na het opslaan voeg je de model ID handmatig toe als de tool geen lijst ophaalt. Sommige editors valideren de sleutel tegen een vaste provider en weigeren aangepaste waarden; zoek dan eerst naar een instelling die de aangepaste of OpenAI-compatible modus inschakelt. Het artikel over het gebruik van een API-sleutel in Kimi-stijl in Cursor behandelt zo'n tool in detail.

Wat verandert als je van provider wisselt

Een overeenkomend formaat betekent niet hetzelfde gedrag. Controleer deze punten één voor één voordat je productieverkeer verplaatst:

  • Uitvoerstijl. Een ander model schrijft anders. Voer je echte prompts uit, geen voorbeeld.
  • Contextgrootte. Het endpoint hier heeft een contextvenster van 100.000 tokens voor prompt plus completion. Als je huidige setup langere prompts verstuurt, knip ze dan eerst bij.
  • Limieten. Een volledige sleutel staat 8 gelijktijdige verzoeken en 300 per minuut toe. Overschrijding van een van beide limieten geeft HTTP 429, met rate_limited of concurrency als code.
  • Functies. Streaming over SSE, function calling en JSON-modus worden ondersteund. Afbeelding-, audio- en videogeneratie, embeddings en fine-tuning zijn niet beschikbaar; dit is een tekst-API.
  • Naamgeving. De service draait één open-weight model dat is gekozen om zonder inhoudelijke weigeringen te antwoorden voor wettelijk volwassen gebruik. Het is geen officiële API van Moonshot en geen router tussen leveranciers.

Een neutrale manier om te vergelijken is om dezelfde tien prompts via beide endpoints te loggen en de antwoorden naast elkaar te lezen. Dat kost enkele minuten en bespaart radenwerk.

Base URL fouten en hoe ze eruitzien

De meeste fouten na een switch komen door het adres, niet door de sleutel. Hier is hoe elke fout zich voordoet en hoe je hem repareert.

FoutSymptoomOplossing
Alleen host, geen /v1404 bij elke aanroepVoeg /v1 aan het einde toe
Volledig pad geplakt404 met een verdubbeld pad in de foutVerkort het adres naar /v1
Achterliggende slash plus handmatige pad-samenvoegingenDubbele slash in de URLLaat de SDK het pad samenvoegen
Oude sleutel, nieuwe URL401Gebruik de sleutel uitgegeven door de nieuwe provider
Oude URL, nieuwe sleutel401 van de oude providerZoek in de repo en de shell naar het oude adres
http:// in plaats van https://Omleiding of verbindingsfoutGebruik overal https

Een snelle manier om achtergebleven items te vinden is je project en implementatie-instellingen doorzoeken op de oude hostnaam. Kijk in .env bestanden, CI-variabelen, Docker compose-bestanden en editor-instellingen, omdat een enkele vergeten kopie genoeg is om verkeer naar de oude provider te sturen.

Streaming en tools na de switch

Stel stream: true in en het antwoord arriveert als server-verzonden gebeurtenissen, met tokenverbruik gerapporteerd aan het einde. Toolaanroep gebruikt de gebruikelijke tools en tool_choice velden, gestreamde tool_calls en resultaten die terug worden gestuurd als berichten met role: "tool". Als je code dit al voor de oude provider afhandelt, zou het moeten blijven werken; bevestig dit door één gestreamde aanroep en één toolaanroep uit te voeren voordat je volledig overschakelt. Onthoud dat een gestreamd verzoek zijn concurrency slot vasthoudt tot de stream eindigt.

Kostencontrole voor je switcht

Facturatie hier is per token: $0,15 per 1M input tokens en $0,50 per 1M output tokens, van prepaid credit, zonder abonnement. Mislukte of geweigerde verzoeken worden niet in rekening gebracht, en credit vervalt niet. Voor de tarieven van een andere provider, kijk op hun huidige prijzingspagina, omdat die veranderen.

Een werkvoorbeeld. Stel een verzoek heeft 2.000 input tokens en 500 output tokens:

  • Input: 2.000 / 1.000.000 x $0,15 = $0,0003
  • Output: 500 / 1.000.000 x $0,50 = $0,00025
  • Totaal: $0,00055 per verzoek, dus 1.000 verzoeken kosten $0,55

De kleinste opwaardering is $20, en grotere opwaarderingen geven een bonus: +5% vanaf $50, +10% vanaf $100 en +15% vanaf $200. Alleen crypto (USDT op TRC20, USDC op Base) wordt geaccepteerd. Volledige details staan op de prijzingspagina, en de Kimi-gerichte opsplitsing staat in prijzen van de Kimi API-sleutel.

Haal een sleutel op en voer de eerste call uit

Meld je aan met Google of met e-mail en wachtwoord, en open vervolgens de API-sleutelpagina. Nieuwe gebruikers kunnen daar met één klik $0,50 aan proeftegoed claimen, één keer per persoon, geldig voor 7 dagen en zonder dat een creditcard nodig is. Proefsleutels zijn beperkt tot 2 gelijktijdige verzoeken en 60 per minuut, wat ruim voldoende is voor een testrun.

Plak de sleutel in de bovenstaande Python-snippet, voer deze uit en controleer of je tekst terugkrijgt. De documentatie vermelden elke parameter, en de responseheaders X-Request-Id en X-Balance-USD helpen bij het debuggen en het bijhouden van je saldo. Prompts die naar de service worden gestuurd, worden niet gebruikt voor training.

Veelgestelde vragen

Is het model hetzelfde als het officiële Kimi van Moonshot?
Nee, we hosten een open-weight model dat is afgestemd om ongecensureerd te zijn. Het is geen GPT, Claude, Gemini, Grok, DeepSeek, of enig ander model van een leverancier. Het is een apart model dat op onze eigen servers draait.

Wordt er met mijn data getraind?
Nee. Je prompts en antwoorden worden niet gebruikt voor training. Wij hechten waarde aan privacy en transparantie, dus jouw data blijft van jou.

Wat zijn de rate limits?
Je bent beperkt tot 300 verzoeken per minuut per sleutel. De maximale grootte van de request body is 8 MB. Deze limieten zijn ontworpen om een stabiele prestatie te garanderen voor alle gebruikers.

Wat is het contentbeleid?
Het model is ongecensureerd wat betreft volwassen, controversiële en creatieve onderwerpen. We blokkeren wel seksuele inhoud met minderjarigen. Dit is een harde limiet die altijd geldt, ongeacht je abonnementsniveau.

Vragen en antwoorden

Moet ik mijn code aanpassen als ik de base URL wijzig?

Meestal slechts drie waarden: base URL, API-sleutel en model ID. Het berichtformaat, streaming en function calling blijven hetzelfde zolang de nieuwe provider deze ondersteunt.

Moet de base URL eindigen op /v1?

Ja voor dit endpoint: https://api.kimiapikey.com/v1. De SDK voegt /chat/completions zelf toe, dus neem het niet op.

Is dit de officiële Moonshot API?

Nee. Het is een onafhankelijk gehost open-weight model achter een OpenAI-compatible API. Het is niet de service van Moonshot en geen router tussen leveranciers.

Waar vind ik het model ID?

Roep GET /v1/models aan met je sleutel. Op dit endpoint is het model ID uncensored.

Je sleutel is nog maar één stap verwijderd

Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.

API-sleutel aanvragenLees de documentatie