package openrouter_api

openrouter-ocaml

An Async-based OCaml client for the OpenRouter API. Full API docs: https://mt-caret.github.io/openrouter-ocaml/.

opam install openrouter_api

Quickstart

open! Core
open! Async
open Openrouter_api

let run_once ~api_key =
  let request =
    Completions.Request.create
      ~model:"openai/gpt-4o-mini"
      ~messages:[ Completions.Request.Message.user "Say pong." ]
      ()
  in
  Completions.create ~api_key request
  >>| function
  | Error error -> eprintf "%s\n" (Error.to_string_hum error)
  | Ok (response : Completions.Response.t) ->
    response.choices
    |> List.iter ~f:(fun (choice : Completions.Response.Choice.t) ->
      Option.iter choice.message.content ~f:print_endline)
;;

Feature Coverage

Example CLI

export OPENROUTER_API_KEY=sk-or-v1-...
dune exec example/openrouter_api_example.exe -- help -recursive -flags

dune exec example/openrouter_api_example.exe -- chat \
  -no-stream \
  -model openai/gpt-4o-mini \
  "say 'pong'"

The full flag reference is generated in example/help.txt.

Development

After substantive edits, run:

dune build
dune runtest
dune fmt

Response fixtures live in test/responses/; request-wire snapshots live in test/test_request_serialization.ml. Use dune runtest --auto-promote to refresh expect tests, then inspect the diff before keeping promoted snapshots.