Documentation

API Reference

Nativ is an OpenAI-compatible AI gateway. Use any model with optional cultural intelligence — just change your base URL.

What is Nativ?

Nativ is an AI gateway that routes your requests to any model (GPT-5.4, Claude, Gemini, DeepSeek, Llama, and more) through a single OpenAI-compatible API. It works as a drop-in replacement for the OpenAI SDK — just change the base URL.

Optionally, pass a nativ parameter to enable cultural intelligence — automatic cultural adaptation of your AI outputs for any target market. The gateway works perfectly fine without it too.

Getting started in 30 seconds

1Get an API key — no credit card

cURLPythonNode.js

curl -X POST https://nativ.nanocorp.app/v1/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

# Response: { "api_key": "nativ_sk_live_...", ... }

import requests

resp = requests.post(
    "https://nativ.nanocorp.app/v1/auth/signup",
    json={"email": "you@example.com"}
)
api_key = resp.json()["api_key"]
print(f"Your API key: {api_key}")

const resp = await fetch("https://nativ.nanocorp.app/v1/auth/signup", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "you@example.com" })
});
const { api_key } = await resp.json();
console.log("Your API key:", api_key);

2Send a request — use any model

Python (OpenAI SDK)cURLNode.js

from openai import OpenAI

client = OpenAI(
    base_url="https://nativ.nanocorp.app/v1",
    api_key="YOUR_KEY"
)

response = client.chat.completions.create(
    model="google/gemini-2.5-flash",
    messages=[{"role": "user", "content": "Hello, world!"}]
)
print(response.choices[0].message.content)

curl https://nativ.nanocorp.app/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [{"role": "user", "content": "Hello, world!"}]
  }'

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://nativ.nanocorp.app/v1",
  apiKey: "YOUR_KEY",
});

const response = await client.chat.completions.create({
  model: "google/gemini-2.5-flash",
  messages: [{ role: "user", content: "Hello, world!" }],
});
console.log(response.choices[0].message.content);

3Add cultural intelligence OPTIONAL

Pass the nativ parameter in extra_body to automatically adapt AI outputs for a target culture. Without it, the gateway works like a standard proxy.

PythoncURLNode.js

from openai import OpenAI

client = OpenAI(
    base_url="https://nativ.nanocorp.app/v1",
    api_key="YOUR_KEY"
)

response = client.chat.completions.create(
    model="google/gemini-2.5-flash",
    messages=[{"role": "user", "content": "Write a marketing email for Japan"}],
    extra_body={"nativ": {"target_culture": "jp", "adapt": True}}
)
print(response.choices[0].message.content)

curl https://nativ.nanocorp.app/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [{"role": "user", "content": "Write a marketing email for Japan"}],
    "nativ": {"target_culture": "jp", "adapt": true}
  }'

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://nativ.nanocorp.app/v1",
  apiKey: "YOUR_KEY",
});

const response = await client.chat.completions.create({
  model: "google/gemini-2.5-flash",
  messages: [{ role: "user", content: "Write a marketing email for Japan" }],
  // @ts-expect-error — Nativ extension
  nativ: { target_culture: "jp", adapt: true },
});
console.log(response.choices[0].message.content);

Base URL

https://nativ.nanocorp.app

OpenAI SDK-compatible. Just set base_url (Python) or baseURL (Node.js) and use it like any OpenAI client.

Authentication

All endpoints except /v1/auth/signup, /v1/models, and /v1/cultures require Bearer token auth.

Header

Authorization: Bearer nativ_sk_live_your_key_here

Endpoints

Complete API reference for all available endpoints.

POST

/v1/chat/completions

The primary gateway endpoint. OpenAI-compatible chat completions — routes to any model on OpenRouter. Optionally pass a nativ object for cultural adaptation.

The nativ parameter (optional)

Field	Type	Description
target_culture	string	Target culture code (e.g. "jp", "fr-FR")
adapt	boolean	Enable cultural adaptation (default: false)

Example

cURLPythonNode.js

curl https://nativ.nanocorp.app/v1/chat/completions \
  -H "Authorization: Bearer nativ_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Write a product description"}
    ],
    "nativ": {"target_culture": "ja-JP", "adapt": true}
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://nativ.nanocorp.app/v1",
    api_key="nativ_sk_live_..."
)

# Without cultural adaptation — standard proxy
response = client.chat.completions.create(
    model="openai/gpt-5.4",
    messages=[{"role": "user", "content": "Explain quantum computing"}]
)

# With cultural adaptation
response = client.chat.completions.create(
    model="openai/gpt-5.4",
    messages=[{"role": "user", "content": "Write a product description"}],
    extra_body={"nativ": {"target_culture": "ja-JP", "adapt": True}}
)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://nativ.nanocorp.app/v1",
  apiKey: "nativ_sk_live_...",
});

// Without cultural adaptation — standard proxy
const response = await client.chat.completions.create({
  model: "openai/gpt-5.4",
  messages: [{ role: "user", content: "Explain quantum computing" }],
});

// With cultural adaptation
const adapted = await client.chat.completions.create({
  model: "openai/gpt-5.4",
  messages: [{ role: "user", content: "Write a product description" }],
  // @ts-expect-error — Nativ extension
  nativ: { target_culture: "ja-JP", adapt: true },
});

GET

/v1/models

List all available models. No authentication required. Returns the same format as the OpenAI models endpoint.

cURL

curl https://nativ.nanocorp.app/v1/models

POST

/v1/adapt

Standalone cultural adaptation endpoint. Send text content and get a culturally-adapted version for your target market. This is a dedicated endpoint — for inline adaptation during chat, use /v1/chat/completions with the nativ parameter instead.

Request Body

Parameter	Type	Required	Description
text	string	required	The text content to adapt
target_culture	string	required	Target culture code (e.g. "ja-JP")
source_culture	string	required	Source culture code (e.g. "en-US")

cURLPythonNode.js

curl -X POST https://nativ.nanocorp.app/v1/adapt \
  -H "Authorization: Bearer nativ_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "text": "This product is a game-changer!",
    "source_culture": "en-US",
    "target_culture": "ja-JP"
  }'

import requests

resp = requests.post(
    "https://nativ.nanocorp.app/v1/adapt",
    headers={"Authorization": "Bearer nativ_sk_live_..."},
    json={
        "text": "This product is a game-changer!",
        "source_culture": "en-US",
        "target_culture": "ja-JP"
    }
)
print(resp.json()["adapted_text"])

const resp = await fetch("https://nativ.nanocorp.app/v1/adapt", {
  method: "POST",
  headers: {
    "Authorization": "Bearer nativ_sk_live_...",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    text: "This product is a game-changer!",
    source_culture: "en-US",
    target_culture: "ja-JP"
  })
});
const { adapted_text } = await resp.json();

POST

/v1/auth/signup

Create an account and get an API key instantly. No credit card required. New accounts start with 500K free tokens per month.

Example Response

Response201 Created

{
  "api_key": "nativ_sk_live_...",
  "account": {
    "id": 12,
    "email": "you@example.com",
    "plan": "free"
  },
  "usage": {
    "period_start": "2026-04-01T00:00:00.000Z",
    "period_end": "2026-05-01T00:00:00.000Z",
    "tokens_used": 0,
    "tokens_limit": 500000
  }
}

GET

/v1/usage

Check your current token usage and limits for the billing period. Requires authentication.

cURL

curl https://nativ.nanocorp.app/v1/usage \
  -H "Authorization: Bearer nativ_sk_live_..."

GET

/v1/cultures

List all supported culture codes for cultural adaptation. No authentication required.

cURL

curl https://nativ.nanocorp.app/v1/cultures

Supported Cultures

en-US

English · United States

en-GB

English · United Kingdom

es-ES

Spanish · Spain

es-MX

Spanish · Mexico

fr-FR

French · France

de-DE

German · Germany

it-IT

Italian · Italy

pt-BR

Portuguese · Brazil

pt-PT

Portuguese · Portugal

ja-JP

Japanese · Japan

ko-KR

Korean · South Korea

zh-CN

Chinese · China

zh-TW

Chinese · Taiwan

hi-IN

Hindi · India

ar-SA

Arabic · Saudi Arabia

tr-TR

Turkish · Turkey

nl-NL

Dutch · Netherlands

sv-SE

Swedish · Sweden

pl-PL

Polish · Poland

id-ID

Indonesian · Indonesia

Endpoint summary

Method	Endpoint	Auth	Description
POST	/v1/chat/completions	required	Chat completions gateway (any model)
GET	/v1/models	none	List available models
POST	/v1/adapt	required	Standalone cultural adaptation
POST	/v1/auth/signup	none	Create account, get API key
GET	/v1/usage	required	Check token usage and limits
GET	/v1/cultures	none	List supported culture codes

Transparent pricing

500K free tokens/month. After that, OpenRouter model cost + 7%. That's it.

View pricing details