OpenAI-compatible model providers

Bring your provider

ViscribeAI focuses on the image extraction workflow: source handling, strict structured output, parsing, and typed results. You bring the model provider and credentials that fit your stack. The built-in clients use OpenAI-compatible Chat Completions. You can use the default OpenAI SDK configuration or pass compatible client options for providers that expose an OpenAI-style API.

OpenAI Compatible

Use any vision-capable model provider that exposes an OpenAI-style Chat Completions API with image inputs and structured output.

Environment variables

For the default OpenAI client, store credentials in your environment.

export OPENAI_API_KEY="sk-your-provider-key"
export OPENAI_MODEL="gpt-5-mini"

OPENAI_MODEL is only used by the examples in this repository. In application code, pass the model explicitly through model_config or modelConfig.

Python configuration

from viscribe.images import extract

result = extract(
    image_path="examples/receipt.png",
    output_schema=[{"name": "total_amount", "type": "number"}],
    model_config={
        "model": "gpt-5-mini",
        "api_key": "sk-your-provider-key",
        "base_url": "https://example-compatible-provider.com/v1",
        "temperature": 1,
        "max_retries": 2,
    },
)

Python client options such as api_key, base_url, timeout, and max_retries are passed to the underlying OpenAI client. Other keys are sent with the model request.

TypeScript configuration

import { images } from "viscribe";

const result = await images.extract({
  imagePath: "examples/receipt.png",
  outputSchema: [{ name: "total_amount", type: "number" }],
  modelConfig: {
    model: "gpt-5-mini",
    apiKey: "sk-your-provider-key",
    baseURL: "https://example-compatible-provider.com/v1",
    temperature: 1,
    maxRetries: 2,
  },
});

TypeScript client options such as apiKey, baseURL, timeout, and maxRetries are passed to the underlying OpenAI client. Other keys are sent with the model request.

Use a vision-capable model that supports image inputs and structured output through an OpenAI-compatible Chat Completions interface.

Getting started

Image extraction

Community

OpenAI-compatible

Bring your provider

OpenAI Compatible

Environment variables

Python configuration

TypeScript configuration

​Bring your provider

OpenAI Compatible

​Environment variables

​Python configuration

​TypeScript configuration

Bring your provider

Environment variables

Python configuration

TypeScript configuration