Catalog

Every API, one key.

Six production APIs sharing one credit balance and one auth scheme. Search, pick an endpoint, and copy a working snippet.

Chat Completions

OpenAI-compatible chat API with function calling, JSON mode, and 128K context. Drop-in replacement for existing integrations — just change the base URL.

LanguagePOST /v1/chat/completions$0.40 per 1M tokens~0.4s latency
Get key

Models

nariwal-1nariwal-1-mininariwal-1-think

Request

curl https://api.nariwal.shop/v1/chat/completions \
  -H "Authorization: Bearer $NARIWAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nariwal-1",
    "messages": [{"role": "user", "content": "Explain quantum computing in one sentence."}]
  }'

Response

{
  "id": "chatcmpl-9f2k1x",
  "model": "nariwal-1",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Quantum computing uses qubits that exist in superposition to solve certain problems exponentially faster than classical computers."
    },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 12, "completion_tokens": 21, "total_tokens": 33 }
}

Vision

Send images by URL or base64 and get rich descriptions, OCR, chart reading, and UI analysis. Perfect for screenshot copilots, document pipelines, and moderation.

VisionPOST /v1/vision/analyze$1.20 per 1K images~1.1s latency
Get key

Models

nariwal-vision-1nariwal-vision-1-mini

Request

curl https://api.nariwal.shop/v1/vision/analyze \
  -H "Authorization: Bearer $NARIWAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nariwal-vision-1",
    "image_url": "https://example.com/dashboard.png",
    "prompt": "Summarize the key metrics in this dashboard."
  }'

Response

{
  "id": "vis-7d21aa",
  "model": "nariwal-vision-1",
  "description": "The dashboard shows 12,480 active users (+8.2% WoW), MRR of $48.2K, and a 2.1% churn rate. The largest traffic source is organic search at 41%.",
  "detected_text": ["Active Users", "12,480", "MRR", "$48.2K"],
  "usage": { "image_units": 1 }
}

Text-to-Speech

Convert text to studio-quality speech with 12 voice personas, adjustable speed and pitch, and sub-300ms first-byte streaming for real-time voice agents.

AudioPOST /v1/audio/speech$6.00 per 1M characters~0.3s latency
Get key

Models

nariwal-tts-1nariwal-tts-1-hd

Request

curl https://api.nariwal.shop/v1/audio/speech \
  -H "Authorization: Bearer $NARIWAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nariwal-tts-1",
    "voice": "aria",
    "input": "Welcome to Nariwal. Your API is ready."
  }' --output speech.mp3

Response

// Binary MP3 stream (audio/mpeg)
// Headers: x-request-id: req_88f1, x-latency-ms: 287

Image Generation

Generate 1024px images in under 8 seconds with prompt enhancement, style presets, and inpainting. Built for marketing teams, game studios, and design tools.

VisionPOST /v1/images/generations$18.00 per 1K images~6.5s latency
Get key

Models

nariwal-img-1nariwal-img-1-turbo

Request

curl https://api.nariwal.shop/v1/images/generations \
  -H "Authorization: Bearer $NARIWAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nariwal-img-1",
    "prompt": "A neon-lit cyberpunk bazaar at night, cinematic, ultra detailed",
    "size": "1024x1024"
  }'

Response

{
  "created": 1728307200,
  "data": [{
    "url": "https://cdn.nariwal.shop/img/gen_4f9a2b1c.png",
    "revised_prompt": "A neon-lit cyberpunk bazaar at night, rain-slicked streets, cinematic lighting, ultra detailed"
  }]
}

Embeddings

Turn text into 1536-dimension vectors tuned for semantic search, recommendations, and retrieval-augmented generation. 8K token context per request.

EmbeddingsPOST /v1/embeddings$0.08 per 1M tokens~0.2s latency
Get key

Models

nariwal-embed-1nariwal-embed-1-large

Request

curl https://api.nariwal.shop/v1/embeddings \
  -H "Authorization: Bearer $NARIWAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nariwal-embed-1",
    "input": "How do I reset my password?"
  }'

Response

{
  "object": "list",
  "data": [{
    "object": "embedding",
    "index": 0,
    "embedding": [0.0023, -0.0089, 0.0142, "..."],
    "dimensions": 1536
  }],
  "model": "nariwal-embed-1",
  "usage": { "prompt_tokens": 8, "total_tokens": 8 }
}

Transcription

Upload audio or point at a URL and get accurate transcripts with word-level timestamps and speaker labels. Ideal for meeting notes, subtitles, and call analytics.

AudioPOST /v1/audio/transcriptions$3.00 per 1K minutes~0.8s latency
Get key

Models

nariwal-whisper-1

Request

curl https://api.nariwal.shop/v1/audio/transcriptions \
  -H "Authorization: Bearer $NARIWAL_API_KEY" \
  -F model="nariwal-whisper-1" \
  -F file="@meeting.mp3" \
  -F response_format="verbose_json"

Response

{
  "task": "transcribe",
  "language": "en",
  "duration": 184.2,
  "text": "Alright team, let's review the Q3 roadmap. First item: the new checkout flow ships on Friday...",
  "segments": [
    { "id": 0, "start": 0.0, "end": 4.2, "text": "Alright team, let's review the Q3 roadmap." }
  ]
}