OpenAI Compatibility Guide

Seamlessly integrate Ask Sage using the standard OpenAI API format

Table of contents

1. What’s New?
2. OpenAI-Compatible Endpoints
   1. Chat Completions
   2. List Available Models
3. How It Works
4. Migration Guide
   1. Key Benefits

What’s New?

Ask Sage now supports the OpenAI message format, making it incredibly easy to:

Easy Migration

Switch from OpenAI to Ask Sage with minimal code changes

Standard Format

Use the same API format and patterns as OpenAI

Familiar Interface

Leverage the standard OpenAI API format you already know

---

OpenAI-Compatible Endpoints

Chat Completions

POST https://api.asksage.ai/server/openai/v1/chat/completions

The main endpoint for conversational AI using the standard OpenAI format.

Authentication: Use Bearer token in the Authorization header

Request Parameters

Authorization string (header) Required

Bearer token authentication: Bearer YOUR_API_KEY

model string Required

The AI model to use (e.g., "gpt-4o-mini", "claude-35-sonnet", etc.)

messages array Required

Array of message objects with roles: system, user, or assistant

• role: Message role (system, user, assistant)
• content: Message content text

temperature number Optional

Controls randomness (0.0-2.0). Higher values make output more creative. Default: 1.0

max_tokens integer Optional

Maximum number of tokens to generate in the response

top_p number Optional

Nucleus sampling parameter (0.0-1.0). Default: 1.0

frequency_penalty number Optional

Reduces likelihood of repeating tokens (-2.0 to 2.0). Default: 0.0

presence_penalty number Optional

Increases likelihood of new topics (-2.0 to 2.0). Default: 0.0

tools array Optional

Array of tool/function definitions for function calling

tool_choice string Optional

Controls tool usage: "none", "auto", or specific tool. Default: "auto"

Response Details

200 Success

Response Structure:

• id: Unique completion ID
• object: "chat.completion"
• created: Unix timestamp
• model: Model used
• choices: Array containing:
  • index: Choice index
  • message: Response message object with role and content
  • finish_reason: Reason for completion (stop, length, etc.)
• usage: Token usage statistics

400 Error

Invalid request format or missing required parameters

401 Error

Authentication failure - invalid or missing API key

Example: Basic Chat Completion

Bash Python JavaScript

curl -X POST 'https://api.asksage.ai/server/openai/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is Ask Sage?"}
    ]
  }'import requests

url = 'https://api.asksage.ai/server/openai/v1/chat/completions'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
data = {
    'model': 'gpt-4o-mini',
    'messages': [
        {'role': 'system', 'content': 'You are a helpful assistant.'},
        {'role': 'user', 'content': 'What is Ask Sage?'}
    ]
}

response = requests.post(url, headers=headers, json=data)
print(response.json())const response = await fetch('https://api.asksage.ai/server/openai/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-4o-mini',
    messages: [
      {role: 'system', content: 'You are a helpful assistant.'},
      {role: 'user', content: 'What is Ask Sage?'}
    ]
  })
});

const data = await response.json();
console.log(data);

Example: Multi-Turn Conversation

Bash Python JavaScript

curl -X POST 'https://api.asksage.ai/server/openai/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "My name is Alice."},
      {"role": "assistant", "content": "Nice to meet you, Alice!"},
      {"role": "user", "content": "What'\''s my name?"}
    ],
    "temperature": 0.3
  }'import requests

url = 'https://api.asksage.ai/server/openai/v1/chat/completions'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
data = {
    'model': 'gpt-4o-mini',
    'messages': [
        {'role': 'system', 'content': 'You are a helpful assistant.'},
        {'role': 'user', 'content': 'My name is Alice.'},
        {'role': 'assistant', 'content': 'Nice to meet you, Alice!'},
        {'role': 'user', 'content': "What's my name?"}
    ],
    'temperature': 0.3
}

response = requests.post(url, headers=headers, json=data)
print(response.json())const response = await fetch('https://api.asksage.ai/server/openai/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-4o-mini',
    messages: [
      {role: 'system', content: 'You are a helpful assistant.'},
      {role: 'user', content: 'My name is Alice.'},
      {role: 'assistant', content: 'Nice to meet you, Alice!'},
      {role: 'user', content: "What's my name?"}
    ],
    temperature: 0.3
  })
});

const data = await response.json();
console.log(data);

Example: Function Calling

Tip: Function calling enables the model to call external functions or tools to retrieve information

Bash Python JavaScript

curl -X POST 'https://api.asksage.ai/server/openai/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "What'\''s the weather like in San Francisco?"}
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "Get the current weather in a location",
          "parameters": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "description": "The city and state, e.g. San Francisco, CA"
              },
              "unit": {
                "type": "string",
                "enum": ["celsius", "fahrenheit"]
              }
            },
            "required": ["location"]
          }
        }
      }
    ],
    "tool_choice": "auto"
  }'import requests

url = 'https://api.asksage.ai/server/openai/v1/chat/completions'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
data = {
    'model': 'gpt-4o-mini',
    'messages': [
        {'role': 'user', 'content': "What's the weather like in San Francisco?"}
    ],
    'tools': [
        {
            'type': 'function',
            'function': {
                'name': 'get_weather',
                'description': 'Get the current weather in a location',
                'parameters': {
                    'type': 'object',
                    'properties': {
                        'location': {
                            'type': 'string',
                            'description': 'The city and state, e.g. San Francisco, CA'
                        },
                        'unit': {
                            'type': 'string',
                            'enum': ['celsius', 'fahrenheit']
                        }
                    },
                    'required': ['location']
                }
            }
        }
    ],
    'tool_choice': 'auto'
}

response = requests.post(url, headers=headers, json=data)
print(response.json())const response = await fetch('https://api.asksage.ai/server/openai/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-4o-mini',
    messages: [
      {role: 'user', content: "What's the weather like in San Francisco?"}
    ],
    tools: [
      {
        type: 'function',
        function: {
          name: 'get_weather',
          description: 'Get the current weather in a location',
          parameters: {
            type: 'object',
            properties: {
              location: {
                type: 'string',
                description: 'The city and state, e.g. San Francisco, CA'
              },
              unit: {
                type: 'string',
                enum: ['celsius', 'fahrenheit']
              }
            },
            required: ['location']
          }
        }
      }
    ],
    tool_choice: 'auto'
  })
});

const data = await response.json();
console.log(data);

---

List Available Models

GET https://api.asksage.ai/server/openai/v1/models

Retrieve a list of all available AI models in OpenAI format.

Request Parameters

Authorization string (header) Required

Bearer token authentication: Bearer YOUR_API_KEY

Response Details

200 Success

response (object) - Contains:

• object: "list"
• data: Array of model objects with:
  • id: Model identifier
  • object: "model"
  • created: Creation timestamp
  • owned_by: Model provider

401 Error

Authentication failure

Bash Python JavaScript

curl -X GET 'https://api.asksage.ai/server/openai/v1/models' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json'import requests

url = 'https://api.asksage.ai/server/openai/v1/models'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'application/json'
}

response = requests.get(url, headers=headers)
print(response.json())const response = await fetch('https://api.asksage.ai/server/openai/v1/models', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'application/json'
  }
});

const data = await response.json();
console.log(data);

How It Works

Ask Sage's openai/v1/* endpoints follow the exact same API specification as OpenAI, making integration seamless.

Using the Same Pattern as OpenAI

You can use Ask Sage's API with the same request/response patterns you're familiar with from OpenAI. Simply point your requests to Ask Sage's base URL with Bearer token authentication.

Key Difference: Instead of using OpenAI's base URL (https://api.openai.com/v1), use Ask Sage's base URL (https://api.asksage.ai/server/openai/v1)

Example: Making Requests

Bash Python JavaScript

# Ask Sage API (OpenAI-compatible format)
curl -X POST 'https://api.asksage.ai/server/openai/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'import requests

# Ask Sage API (OpenAI-compatible format)
url = 'https://api.asksage.ai/server/openai/v1/chat/completions'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
data = {
    'model': 'gpt-4o-mini',
    'messages': [
        {'role': 'user', 'content': 'Hello!'}
    ]
}

response = requests.post(url, headers=headers, json=data)
print(response.json())// Ask Sage API (OpenAI-compatible format)
const response = await fetch('https://api.asksage.ai/server/openai/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-4o-mini',
    messages: [
      {role: 'user', content: 'Hello!'}
    ]
  })
});

const data = await response.json();
console.log(data);

Same Patterns: Use the same request structure, parameters, and response formats you're already familiar with from OpenAI

---

Migration Guide

Key Benefits

Easy Migration

Minimal code changes to switch from OpenAI to Ask Sage

Familiar Patterns

Use the same API patterns and structure as OpenAI

---

Important Note: Base URLs may vary depending on your environment. For assistance, please contact us at support@asksage.ai