SDKs & Libraries

Overview

AI Sonar is easiest to integrate by matching the SDK to the behavior you need:

official Anthropic SDKs for Claude-native /v1/messages behavior
official Gemini / Google AI tooling for Gemini-native request shapes
official OpenAI SDKs for OpenAI-compatible /v1 routes and Responses-style usage

Use the integration pages for support boundaries. In this docs set, “recommended” or “supported” means a documented setup path exists; it does not automatically cover every framework helper or provider-specific feature.

Recommended SDKs

OpenAI Python

pip install openai

OpenAI Node

npm install openai

OpenAI Go

go get github.com/openai/openai-go/v3

Anthropic SDK

Native Claude Messages API support

OpenAI SDK Example

Use this when you are migrating an existing OpenAI-compatible client or want the /v1 compatibility path. For Claude-native or Gemini-native features, use the matching native SDK instead.

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.aisonar.dev/v1"
)

response = client.responses.create(
    model="gpt-5.4",
    input="Explain AI Sonar in one sentence."
)

print(response.output_text)

OpenAI Go Example

package main

import (
    openai "github.com/openai/openai-go/v3"
    "github.com/openai/openai-go/v3/option"
)

func main() {
    client := openai.NewClient(
        option.WithAPIKey("sk-your-api-key"),
        option.WithBaseURL("https://api.aisonar.dev/v1"),
    )

    _ = client
}

Anthropic SDK Example

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-api-key",
    base_url="https://api.aisonar.dev"
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)

Which SDK Should You Use?

Goal	Recommended path
Provider-native behavior	Native provider SDK or route
Existing OpenAI-compatible client	OpenAI SDK on AI Sonar `/v1`
Portable chat / embeddings	OpenAI-compatible `/v1` routes
Claude-native features	Anthropic SDK
Gemini-native request shapes	Gemini-native API / SDK
LangChain / LlamaIndex / Vercel AI SDK	Use the dedicated integration pages

Best Practices

Choose native routes when behavior matters

Use Anthropic or Gemini native routes for provider-specific fields, tools, streaming details, and other behavior that should not be translated through another format.

Use OpenAI-compatible `/v1` for migration

OpenAI-compatible SDKs are the best path for existing OpenAI-style clients, portable chat, and embeddings. Treat them as a compatibility route, not as the only AI Sonar API surface.

Keep base URLs explicit

Pass AI Sonar base URLs directly in your client configuration instead of relying on older environment-variable aliases.

Compatibility Matrix

Coding Tools

Native SDKs

Frameworks & Platforms

Chat Apps

Overview

Recommended SDKs

OpenAI Python

OpenAI Node

OpenAI Go

Anthropic SDK

OpenAI SDK Example

OpenAI Go Example

Anthropic SDK Example

Which SDK Should You Use?

Best Practices

​Overview

​Recommended SDKs

OpenAI Python

OpenAI Node

OpenAI Go

Anthropic SDK

​OpenAI SDK Example

​OpenAI Go Example

​Anthropic SDK Example

​Which SDK Should You Use?

​Best Practices

Overview

Recommended SDKs

OpenAI SDK Example

OpenAI Go Example

Anthropic SDK Example

Which SDK Should You Use?

Best Practices