Authentication

API Keys

All requests to the Samurai AI API must include your API key as a Bearer token in the Authorization header.

Authorization: Bearer sk-samurai-YOUR_API_KEY

Getting Your API Key

Log in to your Dashboard
Navigate to Settings → API Keys
Click + Create API Key
Give it a name (e.g., “Production”, “Development”)
Copy and store it securely — it won’t be shown again

Using Your API Key

from openai import OpenAI

client = OpenAI(
    api_key="sk-samurai-YOUR_API_KEY",  # Your Samurai AI key
    base_url="https://api.samuraiapi.in/v1"
)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.SAMURAI_API_KEY,  // Use env variable
  baseURL: 'https://api.samuraiapi.in/v1'
});

curl https://api.samuraiapi.in/v1/chat/completions \
  -H "Authorization: Bearer $SAMURAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role":"user","content":"Hi"}]}'

Environment Variables

Always store your API key in environment variables, never hardcode it:

.env

SAMURAI_API_KEY=sk-samurai-xxxxxxxxxxxxxxxxxxxx

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("SAMURAI_API_KEY"),
    base_url="https://api.samuraiapi.in/v1"
)

Never expose your API key in:

Client-side JavaScript / browser code
Public GitHub repositories
Log files or error messages
Mobile app bundles

Error Responses

Status	Error	Meaning
`401`	`auth_error`	Missing or invalid API key
`403`	`permission_denied`	Valid key but insufficient plan for this model
`402`	`insufficient_credits`	Your credit balance is depleted

Managing API Keys

Create multiple keys for different environments (dev, staging, prod)
Rotate keys periodically for security
Delete unused keys from your dashboard
Keys can be revoked instantly if compromised

Overview

Getting Started

Chat & Text

Anthropic Format

Audio

SDKs & Libraries

API Keys

Getting Your API Key

Using Your API Key

Environment Variables

Error Responses

Managing API Keys

​API Keys

​Getting Your API Key

​Using Your API Key

​Environment Variables

​Error Responses

​Managing API Keys

API Keys

Getting Your API Key

Using Your API Key

Environment Variables

Error Responses

Managing API Keys