para

head

OpenRouter::API::Result::Model - One model from OpenRouter's catalogue


code

=begin code :lang<raku>

use OpenRouter::API::Client;

my $or = OpenRouter::API::Client.new;
my @models = $or.get-models;

for @models -> $m {
    say $m.id, "  ", $m.name;
    say "  ctx: ",       $m.context-length;
    say "  vision: ",    $m.supports-vision;
    say "  tools: ",     $m.supports-tool-use;
    say "  cheapest $: ", $m.input-price-per-token // 'n/a';
}

=end code


Wraps a single entry from C<GET /models>. Named accessors cover the
fields callers reach for most often; C<.raw> returns the wire hash
for anything else. Prices come back as C<Rat> in USD-per-token
(OpenRouter's wire format is a string like C<"0.000005">).



unit class OpenRouter::API::Result::Model;

has %!data;

submethod BUILD(:%!data) { }

method new(:%data --> OpenRouter::API::Result::Model:D) {
	self.bless(:%data);
}

#|( Top-level identifier: e.g. C<"anthropic/claude-opus-4.7">. )
method id(--> Str:D) { %!data<id> // '' }

#|( Date-stamped slug: e.g. C<"anthropic/claude-opus-4.7-2026-04-16">.
    Useful when referring to an exact version of a model. )
method canonical-slug(--> Str) { %!data<canonical_slug> }

method name(--> Str)             { %!data<name> }
method description(--> Str)      { %!data<description> }
method context-length(--> Int)   { %!data<context_length> // 0 }

#|( Input modalities (e.g. C<<text image>>). Derived from
    C<architecture.input_modalities>, falling back to the legacy
    C<architecture.modality> string (e.g. C<"text+image->text">)
    when input_modalities isn't set. )
method input-modalities(--> List) {
	return %!data<architecture><input_modalities>.List
		if (%!data<architecture> // {})<input_modalities>:exists;
	my $m = (%!data<architecture> // {})<modality> // '';
	return $m.split('->').head.split('+').List if $m.chars;
	().List;
}

#|( Output modalities (e.g. C<<text>>). Same shape as input-modalities. )
method output-modalities(--> List) {
	return %!data<architecture><output_modalities>.List
		if (%!data<architecture> // {})<output_modalities>:exists;
	my $m = (%!data<architecture> // {})<modality> // '';
	return $m.split('->').tail.split('+').List if $m.contains('->');
	().List;
}

#|( OpenRouter tags (e.g. C<<max_tokens tools structured_outputs>>).
    Used by C<supports-tool-use>, C<supports-structured-outputs>, etc. )
method supported-parameters(--> List) {
	(%!data<supported_parameters> // []).List;
}

method supports-tool-use(--> Bool:D) {
	so self.supported-parameters.any eq 'tools'|'tool_choice';
}

method supports-structured-outputs(--> Bool:D) {
	so self.supported-parameters.any eq 'structured_outputs'|'response_format';
}

method supports-reasoning(--> Bool:D) {
	so self.supported-parameters.any eq 'reasoning'|'include_reasoning';
}

method supports-vision(--> Bool:D) {
	so self.input-modalities.any eq 'image';
}

#|( Advertised prompt-token price (USD / token) at the catalogue
    level. Returns a C<Rat> or Nil if the wire field is absent.
    The catalogue view exposes a single representative price; see
    C<get-model-endpoints> to compare provider-level pricing. )
method input-price-per-token(--> Rat) {
	self!parse-price(%!data<pricing><prompt>);
}

method output-price-per-token(--> Rat) {
	self!parse-price(%!data<pricing><completion>);
}

#|( Is the model tagged as free to call? OR marks free-tier variants
    with C<:free> suffixes, or sets both pricing fields to the
    string C<"0">. Normalises both. )
method is-free(--> Bool:D) {
	return True if self.id.contains(':free');
	my $p = self.input-price-per-token;
	my $c = self.output-price-per-token;
	$p.defined && $p == 0 && $c.defined && $c == 0;
}

#|( Verbatim response hash. Escape hatch for fields the wrapper
    doesn't expose as named accessors. )
method raw(--> Hash) { %!data.Hash }

method !parse-price($v --> Rat) {
	return Rat unless $v.defined;
	# OR sends prices as strings — parse defensively; a malformed
	# value returns Nil rather than throwing.
	return try { $v.Rat } // Rat;
}


root

Provider

Generation

React

=begin React :component<HeaderCol> :id<menu> 
=para L<Documentation|/doc/introduction>
=para L<Modules| /mods>
=para L<Examples| file:../examples/index.podlite>
=para L<AI|file:../mcp/index.podlite>
=para L<Download |file:../download/index.podlite>
=para L<About|file:../about/index.podlite>
=para 🔍 K<⌘K>/K<ctrl-K>
=end React


=begin React :component<HeaderCol> :id<footer>  
=begin nested :!nested
=item1 B<Language>
    =item2 L<Get started|file:../getting-started/getting-started.podlite>
    =item2 L<Why Raku?|/doc/language/faq#Why-should-I-learn-Raku-What's-so-great-about-it>
    =item2 L<Try Raku|https://glot.io/new/raku>
    =item2 L<Download | file:../download/index.podlite>
    =item2 L<Raku cheat sheet|https://github.com/Raku/mu/blob/master/docs/Perl6/Cheatsheet/cheatsheet.txt>
    =item2 L<Raku on Exercism|https://exercism.org/tracks/raku>
    =item2 L<Wikipedia|https://en.wikipedia.org/wiki/Raku_(programming_language)>

=end nested
=begin nested :!nested

=item1 B<L<Documentation|/doc>>
    =item2 L<Getting started, Migration guides from other languages, & Tutorials | file:../doc/introduction.podlite>
    =item2 L<Language References|file:../doc/reference.podlite>
    =item2 L<Type Reference| file:../doc/types.podlite>
    =item2 L<Miscellaneous| file:../doc/miscellaneous.podlite>
    =item2 L<FAQs (Frequently Asked Questions)|/doc/language/faq>
    =item2 L<Community|/doc/language/community>
    =item2 L<The list of all documents|file:../doc/index.podlite>
    =item2 L<Hand these documents to an AI assistant|file:../mcp/index.podlite>

=end nested
=begin nested :!nested
=item1 B<Learning>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Wikibook |https://en.wikibooks.org/wiki/Raku_Programming>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>
    =item2 L<Learn Raku in Y minutes|https://learnxinyminutes.com/docs/raku/>
    =item2 L<Golfing |https://github.com/AlexDaniel/raku-golf-cheatsheet>
=end nested
=begin nested :!nested

=item1 B<Explore>
    =item2 L<Raku Blog Aggregator|https://planet.raku.org/>
    =item2 L<Rakudo Weekly|https://rakudoweekly.blog/>
    =item2 L<The Weekly Challenge |https://perlweeklychallenge.org/>
    =item2 L<Raku Advent Calendar|https://raku-advent.blog/>

=end nested
=end React


Built with L<Podlite|https://podlite.org> — the markup and publishing tools behind this site.


=begin React :component<CookieConsent> :id<CookieConsent> :buttonCaption("Got it!")
=para
This website uses cookies for analytics.
=end React


Model

NAME

SYNOPSIS

DESCRIPTION

OpenRouter::API v0.1.1

Authors

License

Dependencies

Test Dependencies

Provides

Documentation