Felo API PlatformFelo API Platform

Handleidingen

Modellen en prijzen

Begrijp model-ID's, aanbieders, gepubliceerde tarieven, kortingen, facturatie-eenheden en hoe een aanvraag wordt geprijsd.

Modelprijzen worden gepubliceerd in Amerikaanse dollars. Een model kan via meer dan één upstream-provider beschikbaar zijn en elke provider kan een andere klantprijs publiceren. Deze handleiding legt uit waar die prijzen vandaan komen en hoe je een verzoek doorrekent voordat je het verstuurt.

Een model-ID vinden

Gebruik het model-ID dat de API teruggeeft. Stel een ID niet samen uit de weergavenaam of de paginaslug.

EndpointRetourneert
GET /api/v1/modelsElke ingeschakelde modelcategorie
GET /api/v1/videos/modelsModellen voor videogeneratie
GET /api/v1/decisions/modelsBeslissingsmodellen

GET /api/v1/models accepteert ook exclude_video_and_decisions=true en een optionele provider-filter. Bij detectie wordt de catalogus gelezen en wordt geen modelaanroep in rekening gebracht.

Beeldmodellen hebben geen eigen lijst-endpoint. Filter GET /api/v1/models op model_kind: "image_generation"; zie Beeldgeneratie.

Wil je door de catalogus bladeren? Open de modelcatalogus of de prijzenpagina. Op modeldetailpagina's zie je contextlimieten, protocollen en elke gepubliceerde leveranciersprijs.

Providers en kanalen

Elk model heeft een lijst met openbare kanalen. Een kanaal is één configuratie van een upstream-provider voor dat model, bijvoorbeeld Anthropic, Azure, Google of een kanaal met korting voor Claude.

  • is_default markeert het kanaal dat wordt gebruikt voor de getoonde hoofdprijs en de standaardroute.
  • runnable geeft aan of het kanaal momenteel beschikbaar is voor verzoeken.
  • standard_pricing bevat de standaardtarieven van de provider.
  • discount_multiplier is de kortingsfactor van 0 tot 1.
  • pricing_mode is configured_rates of upstream_cost.

De modelpagina sorteert leveranciers met de standaardprovider eerst en daarna op klantprijs voor invoer van laag naar hoog. Zie Kanalen en providerroutering om expliciet een leverancier te kiezen.

Hoe een klantprijs wordt berekend

Voor een kanaal met configured_rates:

customer price = standard rate × discount multiplier

Een kanaal met een standaardtarief voor invoer van $1.00 per 1M tokens en een factor van 0.8 rekent bijvoorbeeld $0.80 per 1M tokens.

Bij een kanaal met upstream_cost is standard_pricing null, niet nul. De facturering is gebaseerd op de gerapporteerde generatiekosten vermenigvuldigd met de vastgezette korting. De modelpagina toont de werkelijke regel voor dat kanaal.

Tokentarieven worden voor de leesbaarheid per 1 miljoen tokens getoond. Bij de facturering wordt de precisie per token uit de actuele prijsmomentopname gebruikt.

Factureringseenheden

EenheidTypisch gebruikHoe wordt het gemeten
TokensChat, redeneren, embeddings, tekstgeneratieInvoer- en uitvoertokens apart; het lezen en schrijven van cache kan eigen tarieven hebben
BeeldtokensBeeldgeneratie en -bewerkingInvoer- en uitvoerbeeldtokens apart; het aantal uitvoertokens per afbeelding hangt af van de resolutie
VerzoekenSommige beeld- en hulpendpointsEen vast bedrag per aanroep
Seconden of staffelsVideogeneratieDuur, resolutie, referentie-invoer of een andere gepubliceerde voorwaarde

Als meerdere prijsvoorwaarden van toepassing zijn, geldt de eerst vermelde voorwaarde in de prijsdetails van het model. Controleer de staffels op de modeldetailpagina voordat je een grote opdracht inschat.

Cachetarieven

Wanneer een model input_cache_read of input_cache_write publiceert, verschijnen die tarieven in de catalogus en op de modelpagina. Cachegebruik wordt gerapporteerd in de protocolrespons; een cachehit is niet gegarandeerd en hangt af van de upstream-provider en het verzoek. Felo voegt geen aparte cacheschakelaar toe.

Waar je prijzen controleert

  • Prijzenpagina — vergelijk modellen en leveranciers.
  • Modeldetailpagina — volledige tarieventabel, staffels en voorwaarden.
  • Modelcatalogus-API — dezelfde gegevens in JSON, binnen 60 seconden vernieuwd.

Hardcode geen prijzen in je applicatie. Lees de catalogus of toon een link naar de prijzenpagina, zodat een prijswijziging je kostenraming niet geruisloos ondermijnt.

Een verzoek inschatten

  1. Zoek het model-ID en het kanaal dat je wilt gebruiken.
  2. Lees de invoer-, uitvoer- en cachetarieven van dat kanaal.
  3. Vermenigvuldig met het verwachte aantal tokens, of gebruik het tarief per verzoek of per seconde voor modellen die niet op tokens worden afgerekend.
  4. Tel een voorwaardelijke staffel op als die van toepassing is.
  5. Houd ruimte over voor nieuwe pogingen en variatie in de uitvoer.

Gerelateerd