Quickstart

Getting Started

Neosantara acts as a unified gateway, allowing you to access various advanced models from different providers using a single API key and your choice of SDK.

Get your API Key

Sign up or Login at the Neosantara App.
Go to the Dashboard to view your initial free credits.
Create a new key in the API Keys section.
Copy your key (it starts with nsk_).

Dashboard

Manage account, billing, and stats.

API Keys

Manage your access credentials.

Choose Your Model

Access the world’s best models through a single interface. Switch models by simply changing the model string.

Flagship Reasoning: deepseek-r1, claude-4.5-sonnet
High-Speed Chat: gemini-3.5-flash, grok-4.1-fast-non-reasoning
Specialized: deepseek-ocr, neosantara-gen-2045 (Image Gen)

See the Models Overview for full pricing and technical specs.

Pick Your SDK

Neosantara is “triple-compatible.” Use the SDK that fits your existing workflow.

Protocol	Use Case	Base URL
OpenResponses	Stateful, modern apps	`https://api.neosantara.xyz/v1`
OpenAI SDK	Legacy compatibility	`https://api.neosantara.xyz/v1`
Anthropic SDK	native Claude users	`https://api.neosantara.xyz/anthropic`

Make Your First Call

Once you have your API Key, you can start making requests.

Want your product to show up consistently in Neosantara’s public app rankings? Send X-Neosantara-App-Url, X-Neosantara-App-Name, and optionally X-Neosantara-App-Description. See Authentication.

OpenResponses (Recommended)
OpenAI SDK
Anthropic SDK

Recommended for stateful, high-performance apps.

const response = await fetch('https://api.neosantara.xyz/v1/responses', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_NSK_KEY',
    'X-Neosantara-App-Url': 'https://example.ai',
    'X-Neosantara-App-Name': 'Example AI'
  },
  body: JSON.stringify({
    model: 'gemini-3.5-flash',
    input: 'What is the capital of Indonesia?',
    store: true
  })
});

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

Drop-in replacement for OpenAI integrations.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_NSK_KEY",
    base_url="https://api.neosantara.xyz/v1",
    default_headers={
        "X-Neosantara-App-Url": "https://example.ai",
        "X-Neosantara-App-Name": "Example AI"
    }
)

response = client.chat.completions.create(
    model="deepseek-r1",
    messages=[{"role": "user", "content": "1+1=?"}]
)
print(response.choices[0].message.content)

Native support for Anthropic Messages format.

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_NSK_KEY",
    base_url="https://api.neosantara.xyz/anthropic"
)

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

Next Steps

Streaming

Learn how to handle real-time data flows.

Reasoning

Configure chain-of-thought and thinking tokens.

Last modified on August 6, 2026

Getting Started

SDKs & APIs

Core Concepts

Jelma

Capabilities

Getting Started

Dashboard

API Keys

Next Steps

Streaming

Reasoning

​Getting Started

Dashboard

API Keys

​Next Steps

Streaming

Reasoning

Getting Started

Next Steps