Custom Providers

A custom provider is a separate app that depends on AI Open SDK (core) and returns models through the same interfaces as Anthropic, OpenAI, and OpenCode Zen.

What you implement

The SDK already ships reusable formats:

• "AIOS Chat Completions Format" in AI Open SDK Provider Utils, for Chat Completions endpoints
• "AIOS Anthropic Format" in AI Open SDK Anthropic, for the Anthropic Messages format

Reuse one of those when your endpoint matches that format. Implement "AIOS Chat Format" when your endpoint uses a different format.

Extension layout

1. Create a new AL app with its own idRanges and App Id.
2. Add a dependency on AI Open SDK (core) in app.json.
3. Implement the language (and optional image) model codeunits.
4. Expose a public factory codeunit (same pattern as "AIOS Anthropic"): Model(ModelId, KeyValue), SetApiKey, optional SetBaseUrl / version helpers.
5. Cover behavior with "AIOS Mock" (in Core) in tests. Live keys stay out of CI.

"dependencies": [
  {
    "id": "<core-app-id>",
    "name": "AI Open SDK",
    "publisher": "Guillermo Padilla",
    "version": "0.1.0.0"
  }
]

Consumer usage

Downstream apps depend on core plus your provider app, then call your factory and "AIOS Client":

MyProvider: Codeunit "My AIOS Provider";
Client: Codeunit "AIOS Client";
Result: Codeunit "AIOS Generate Result";
ApiKey: SecretText;
begin
    Result := Client.GenerateText(
        MyProvider.Model('my-model', ApiKey),
        Prompt);
end;

The public model and request interfaces are the contract between your provider and its consumers. Keep provider-specific details inside the provider app so consumers can use your factory with the same "AIOS Client" APIs as the built-in providers.