API Documentation v1.0

Build with SarangAI — 200+ models.

OpenAI-compatible access to 200+ models. Change the base URL, use your SarangAI API key, and start building.

01 · QUICKSTART

Connect in minutes

Base URL

https://sarangai.id/api/gateway/v1

Authentication

Authorization: Bearer sk-sarang-xxx

bash

curl -X POST https://sarangai.id/api/gateway/v1/chat/completions \
  -H "Authorization: Bearer sk-sarang-xxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek/deepseek-r1","messages":[{"role":"user","content":"Hello SarangAI!"}]}'

02 · TOOL INTEGRATIONS

Connect your development tools

Select a tool to see its SarangAI connection settings and setup commands.

settings

OpenAI API Key: sk-sarang-xxx
Base URL: https://sarangai.id/api/gateway/v1

03 · API REFERENCE

Endpoints

POST

https://sarangai.id/api/gateway/v1/chat/completions

Chat & Reasoning — Send messages to your chosen model and receive an OpenAI-compatible response.

GET

/models

Model catalog — List 200+ active models with provider, context, and pricing.

POST

/images/generations

Image generation — An image generation endpoint compatible with the OpenAI pattern.

04 · MODELS

Popular model IDs

Use these exact IDs in your API requests. The full catalog is available in Model Catalog.

OpenAI

openai/gpt-4o

OpenAI

openai/gpt-4o-mini

Anthropic

anthropic/claude-3.5-sonnet

Anthropic

anthropic/claude-3.5-haiku

DeepSeek

deepseek/deepseek-r1

Google

google/gemini-2.5-flash

05 · RELIABILITY

Status & error handling

HTTP	Status	Description
200 OK	Success	Successful request and completion returned.
401	Unauthorized	Invalid, missing, or revoked SarangAI API key.
402	Payment Required	Insufficient virtual credit balance. Top up via /user/wallet.
429	Too Many Requests	Rate limit reached. Please implement exponential backoff.
500 / 502	Upstream Failure	Upstream provider error. The gateway will automatically attempt retry or fallback.

06 · BILLING

Pay As You Go

Token-based balance deduction per request

Credits are deducted dynamically per successful request based on input (prompt) and output (completion) token consumption according to model pricing. No hidden fees or recurring monthly subscriptions.

Recharge your credits instantly via the Wallet panel with supported automated payment channels.

Ready to build?

Create an API key and make your first request.

Create API Key

Connect in minutes

Base URL

https://sarangai.id/api/gateway/v1

Authentication

Authorization: Bearer sk-sarang-xxx

bash

curl -X POST https://sarangai.id/api/gateway/v1/chat/completions \
  -H "Authorization: Bearer sk-sarang-xxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek/deepseek-r1","messages":[{"role":"user","content":"Hello SarangAI!"}]}'

Endpoints

POST

https://sarangai.id/api/gateway/v1/chat/completions

Chat & Reasoning — Send messages to your chosen model and receive an OpenAI-compatible response.

GET

/models

Model catalog — List 200+ active models with provider, context, and pricing.

POST

/images/generations

Image generation — An image generation endpoint compatible with the OpenAI pattern.

Status & error handling

HTTP	Status	Description
200 OK	Success	Successful request and completion returned.
401	Unauthorized	Invalid, missing, or revoked SarangAI API key.
402	Payment Required	Insufficient virtual credit balance. Top up via /user/wallet.
429	Too Many Requests	Rate limit reached. Please implement exponential backoff.
500 / 502	Upstream Failure	Upstream provider error. The gateway will automatically attempt retry or fallback.

Pay As You Go

Token-based balance deduction per request

Recharge your credits instantly via the Wallet panel with supported automated payment channels.