ai& SDK

The official ai& SDKs are generated from the public OpenAPI spec and ship full type definitions. They cover the same OpenAI-compatible surface as the rest of the platform.

Setup

Python
TypeScript

pip install aiand

import aiand

configuration = aiand.Configuration(access_token="sk-your-aiand-api-key")
client = aiand.OpenaiApi(aiand.ApiClient(configuration))

models = client.list_models()
print(models.data[0].id)

npm install @aiand/sdk

import { Configuration, OpenaiApi } from "@aiand/sdk";

const client = new OpenaiApi(
  new Configuration({ accessToken: "sk-your-aiand-api-key" }),
);

const models = await client.listModels();
console.log(models.data[0].id);

Chat completion

Python
TypeScript

response = client.create_chat_completion(
    aiand.CreateChatCompletionRequest.from_dict({
        "model": "google/gemma-4-31b-it",
        "messages": [{"role": "user", "content": "Hello"}],
    })
)
print(response.choices[0].message.content)

const response = await client.createChatCompletion({
  createChatCompletionRequest: {
    model: "google/gemma-4-31b-it",
    messages: [{ role: "user", content: "Hello" }],
  },
});
console.log(response.choices[0].message.content);

Responses

Python
TypeScript

response = client.create_response(
    aiand.CreateResponseRequest(
        model="google/gemma-4-31b-it",
        input=aiand.ResponseInput("Hello"),
    )
)
# output[0] is often a reasoning item
message = next((item for item in response.to_dict()["output"] if item["type"] == "message"), None)
if message:
    print(message["content"][0]["text"])
else:
    print(f"No message in the output (status: {response.status})")

const response = await client.createResponse({
  createResponseRequest: {
    model: "google/gemma-4-31b-it",
    input: "Hello",
  },
});
console.log(response.output);

Other surfaces

list_models() / listModels() — Models
Files, uploads, and more follow the same client — see Files