Skip to main content

​
API Reference

​
Base URL

https://api.pureai-api.com

​
Authentication

All requests require an API key via header: 
x-api-key: {your-api-key}

​
Endpoints

​
POST /v1/chat/completions

Create a chat completion. Request: 
{
  "model": "gpt-4o-mini",
  "messages": [
    {"role": "system", "content": "You are helpful."},
    {"role": "user", "content": "Hello!"}
  ],
  "max_tokens": 100,
  "temperature": 0.7,
  "top_p": 1.0,
  "stream": false,
  "stop": ["\n"]
}
Parameters:
FieldTypeRequiredDescription
modelstringYesModel identifier
messagesarrayYesConversation messages
max_tokensintegerNoMaximum tokens to generate
temperaturefloatNoRandomness (0-2)
top_pfloatNoNucleus sampling
streambooleanNoEnable streaming
stoparrayNoStop sequences
Response: 
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1699123456,
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 9,
    "total_tokens": 21,
    "input_cost_usd": 0.000018,
    "output_cost_usd": 0.000027,
    "total_cost_usd": 0.000045,
    "latency_ms": 523.4,
    "ttft_ms": 215.2
  }
}

​
POST /v1/completions

Create a text completion. Request: 
{
  "model": "gpt-4o-mini",
  "prompt": "The capital of France is",
  "max_tokens": 50,
  "temperature": 0.7,
  "stop": ["."]
}
Parameters:
FieldTypeRequiredDescription
modelstringYesModel identifier
promptstringYesText prompt
max_tokensintegerNoMaximum tokens
temperaturefloatNoRandomness
stoparrayNoStop sequences
Response: 
{
  "id": "cmpl-abc123",
  "object": "text_completion",
  "created": 1699123456,
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "text": " Paris",
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 5,
    "completion_tokens": 1,
    "total_tokens": 6,
    "input_cost_usd": 0.000008,
    "output_cost_usd": 0.000003,
    "total_cost_usd": 0.000011,
    "latency_ms": 312.1
  }
}

​
GET /v1/models

List available models. Response: 
{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o-mini",
      "object": "model",
      "created": 1699000000,
      "owned_by": "openai"
    },
    {
      "id": "claude-3-haiku",
      "object": "model",
      "created": 1699000000,
      "owned_by": "anthropic"
    }
  ]
}

​
GET /v1/providers

List providers for a model. Query Parameters:
FieldTypeRequiredDescription
modelstringYesModel identifier
Response: 
{
  "providers": [
    {
      "id": "openai",
      "type": "primary",
      "enabled": true,
      "params": {}
    },
    {
      "id": "groq",
      "type": "backup",
      "enabled": true,
      "params": {}
    }
  ]
}

​
Message Object

FieldTypeDescription
rolestringsystem, user, or assistant
contentstringMessage content

​
Usage Object

FieldTypeDescription
prompt_tokensintegerInput token count
completion_tokensintegerOutput token count
total_tokensintegerTotal tokens
input_cost_usdfloatInput cost (USD)
output_cost_usdfloatOutput cost (USD)
cache_input_cost_usdfloatCached input cost
total_cost_usdfloatTotal cost (USD)
latency_msfloatRequest latency (ms)
ttft_msfloatTime to first token (ms)

​
Streaming

Set stream: true to receive Server-Sent Events: 
data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant"}}]}

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello"}}]}

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"!"}}]}

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]

​
Rate Limits

Rate limits are applied per API key. When exceeded, you’ll receive a 429 response with retry_after header.

​
SDK Usage

from lunar import Lunar

client = Lunar(api_key="your-key")

# Chat completions
response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello!"}]
)

# Text completions
response = client.completions.create(
    model="gpt-4o-mini",
    prompt="Hello"
)

# List models
models = client.models.list()

# List providers
providers = client.providers.list(model="gpt-4o-mini")