Ask AI

Build with AvalAI

Start with one real request, then follow the documentation path that matches what you are building. AvalAI works with OpenAI-compatible clients through a single base URL.

Start the quickstart Open the API reference

Make your first request

Use the Responses API to confirm your key, client, and model are working together.

Create an API keyOpen the AvalAI dashboard, create a project key, and keep it on the server.
Install a clientUse the OpenAI SDK for Python or JavaScript, or send the same request with cURL.
Send a Responses requestSet AVALAI_API_KEY, run the example, and read response.output_text.

PythonJavaScriptBash

python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AVALAI_API_KEY"],
    base_url="https://api.avalai.ir/v1",
)

response = client.responses.create(
    model="gpt-5.6-sol",
    input="Give me one practical idea for a developer tool.",
)

print(response.output_text)

javascript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AVALAI_API_KEY,
  baseURL: "https://api.avalai.ir/v1",
});

const response = await client.responses.create({
  model: "gpt-5.6-sol",
  input: "Give me one practical idea for a developer tool.",
});

console.log(response.output_text);

bash

curl https://api.avalai.ir/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AVALAI_API_KEY" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "Give me one practical idea for a developer tool."
  }'