/ 
Langertha-0.202
River stage zero No dependents
/ Langertha::Engine::AKIOpenAI

NAME

Langertha::Engine::AKIOpenAI - AKI.IO via OpenAI-compatible API

VERSION

version 0.202

SYNOPSIS

use Langertha::Engine::AKIOpenAI;

# Direct construction (use /v1 model names, NOT native AKI names)
my $aki = Langertha::Engine::AKIOpenAI->new(
    api_key => $ENV{AKI_API_KEY},
    model   => 'llama3-chat-8b',
);

print $aki->simple_chat('Hello!');

# Streaming
$aki->simple_chat_stream(sub {
    print shift->content;
}, 'Tell me about Perl');

# Via AKI's openai() method (uses default model)
use Langertha::Engine::AKI;

my $aki_native = Langertha::Engine::AKI->new(
    api_key => $ENV{AKI_API_KEY},
    model   => 'llama3_8b_chat',
);
my $oai = $aki_native->openai;  # warns: model not mapped, uses default
print $oai->simple_chat('Hello via OpenAI format!');

DESCRIPTION

Provides access to AKI.IO's OpenAI-compatible API at https://aki.io/v1. Composes Langertha::Role::OpenAICompatible for the standard OpenAI format.

AKI.IO is a European AI model hub (Germany) — fully GDPR-compliant with all inference on EU infrastructure. Supports chat completions (with SSE streaming), MCP tool calling, and dynamic model listing.

Embeddings and transcription are not supported. For native AKI.IO API features (top_k, top_p, max_gen_tokens), use Langertha::Engine::AKI.

Get your API key at https://aki.io/ and set LANGERTHA_AKI_API_KEY.

THIS API IS WORK IN PROGRESS

api_key

The AKI.IO API key. If not provided, reads from LANGERTHA_AKI_API_KEY environment variable. Sent as a Bearer token in the Authorization HTTP header. Required.

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/langertha/issues.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de> https://raudss.us/

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.