/ 
Langertha-0.307
River stage one • 1 direct dependent • 1 total dependent
/ Langertha::Engine::AKIOpenAI

NAME

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

VERSION

version 0.307

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) and dynamic model listing. Composes Langertha::Role::HermesTools for MCP tool calling via XML tags (AKI's /v1 endpoint does not support native tool parameters).

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.