Quick Start

# Register
curl -X POST https://api.hontoni.vn/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "your-password", "name": "Your Name"}'

# Create an API key
curl -X POST https://api.hontoni.vn/api/keys \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-key"}'

curl https://api.hontoni.vn/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4",
    "messages": [
      {"role": "user", "content": "Hello, world!"}
    ]
  }'

# Option 1: Authorization header (recommended)
Authorization: Bearer sk-your-api-key

# Option 2: X-API-Key header
X-API-Key: sk-your-api-key

${apiUrl}/v1

# Set environment variables
export ANTHROPIC_BASE_URL=https://api.hontoni.vn/v1
export ANTHROPIC_API_KEY=sk-your-api-key

# Or configure in ~/.claude/config.json
{
  "apiBaseUrl": "https://api.hontoni.vn/v1",
  "apiKey": "sk-your-api-key"
}

API Key: sk-your-api-key
Base URL: https://api.hontoni.vn/v1
Model: claude-sonnet-4

{
  "ai.provider": "openai",
  "ai.openai.baseUrl": "https://api.hontoni.vn/v1",
  "ai.openai.apiKey": "sk-your-api-key",
  "ai.openai.model": "claude-sonnet-4"
}

{
  "models": [
    {
      "title": "Hontoni - Claude Sonnet 4",
      "provider": "openai",
      "model": "claude-sonnet-4",
      "apiBase": "https://api.hontoni.vn/v1",
      "apiKey": "sk-your-api-key"
    }
  ]
}

Provider: OpenAI Compatible
Base URL: https://api.hontoni.vn/v1
API Key: sk-your-api-key
Model: claude-sonnet-4

# Environment variables
export OPENAI_API_BASE=https://api.hontoni.vn/v1
export OPENAI_API_KEY=sk-your-api-key

# Or use flags
aider --openai-api-base https://api.hontoni.vn/v1 \
      --openai-api-key sk-your-api-key \
      --model claude-sonnet-4

{
  "provider": {
    "openai": {
      "apiKey": "sk-your-api-key",
      "baseURL": "https://api.hontoni.vn/v1"
    }
  },
  "model": {
    "default": "claude-sonnet-4"
  }
}

curl -X POST https://api.hontoni.vn/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Explain quantum computing in 3 sentences."}
    ],
    "max_tokens": 200
  }'

curl -X POST https://api.hontoni.vn/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Write a haiku about coding"}
    ],
    "stream": true
  }'

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1700000000,
  "model": "claude-sonnet-4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum computing uses quantum bits..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 50,
    "total_tokens": 75
  }
}

{
  "model": "claude-sonnet-4",
  "messages": [{"role": "user", "content": "Solve: x^2 + 5x + 6 = 0"}],
  "max_tokens": 16000,
  "thinking": {
    "type": "enabled",
    "budget_tokens": 10000
  }
}

curl -X POST https://api.hontoni.vn/v1/messages \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4",
    "max_tokens": 1024,
    "system": "You are a helpful coding assistant.",
    "messages": [
      {"role": "user", "content": "Write a Python fibonacci function"}
    ]
  }'

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4",
  "content": [
    {
      "type": "text",
      "text": "Here's a Python fibonacci function..."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 30,
    "output_tokens": 150
  }
}

{
  "model": "gpt-5.2",
  "input": "What is the meaning of life?",
  "reasoning": {
    "effort": "high",
    "summary": "auto"
  }
}

curl -X POST ${baseUrl}/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{"model": "claude-sonnet-4:high-1m", "messages": [{"role": "user", "content": "Analyze this large codebase..."}]}'

X-RateLimit-Limit-RPM: 12
X-RateLimit-Remaining-RPM: 11
X-RateLimit-Limit-Daily: 250
X-RateLimit-Remaining-Daily: 248
X-RateLimit-Limit-5h: 45
X-RateLimit-Remaining-5h: 43
X-RateLimit-Limit-Weekly: 275
X-RateLimit-Remaining-Weekly: 270
X-RateLimit-Limit-Monthly: 1100
X-RateLimit-Remaining-Monthly: 1095
X-RateLimit-Concurrent-Limit: 2
X-RateLimit-Concurrent-Active: 1

cost = (input_tokens × input_price / 1,000,000)
     + (output_tokens × output_price / 1,000,000)
     + (reasoning_tokens × reasoning_price / 1,000,000)

Input cost:  1,000 × $3.00 / 1,000,000 = $0.003
Output cost: 500 × $15.00 / 1,000,000   = $0.0075
Total cost:  $0.0105

{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

async function callWithRetry(request, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, request);

    if (response.status === 429) {
      const retryAfter = response.headers.get('retry-after');
      const delay = retryAfter ? parseInt(retryAfter) * 1000 : Math.pow(2, i) * 1000;
      await new Promise(r => setTimeout(r, delay));
      continue;
    }

    return response;
  }
  throw new Error('Max retries exceeded');
}

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://api.hontoni.vn/v1',
});

const response = await client.chat.completions.create({
  model: 'claude-sonnet-4',
  messages: [{ role: 'user', content: 'Hello!' }],
});

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://api.hontoni.vn/v1',
});

const message = await client.messages.create({
  model: 'claude-sonnet-4',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Hello!' }],
});