Skip to main content

Guida rapida

Una sola chiave API. Tutti i modelli. Compatibile con OpenAI e Anthropic.

Base URL
Provalo subito
curl https://api.luno.codes/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Hello"}],
    "max_tokens": 1024
  }'
1

Ottieni la chiave API

Dashboard → Chiavi API → Crea

2

Imposta la Base URL

https://api.luno.codes/v1

3

Usa qualsiasi modello

claude-sonnet-4-6, gpt-4o, gemini-3.1-pro...

Autenticazione

Passa la tua chiave API tramite l'header Authorization o x-api-key.

Formato dell'header
Authorization: Bearer YOUR_API_KEY

# or

x-api-key: YOUR_API_KEY
Crea le chiavi API in Dashboard → Chiavi API. Ogni chiave eredita i limiti del tuo piano.

Integrazioni

Sostituzione immediata per qualsiasi strumento che supporti l'API di OpenAI o Anthropic.

Claude CodeClaude Code

Pronto da copiare e incollare. Sostituisci il tuo file di configurazione e sei operativo.

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.luno.codes",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

ANTHROPIC_BASE_URL — senza /v1 (Claude Code lo aggiunge da solo)

Imposta tutti e 3 i DEFAULT_*_MODEL — altrimenti le attività in background falliscono con "model may not exist"

Codex CLICodex CLI

export OPENAI_BASE_URL=https://api.luno.codes/v1
export OPENAI_API_KEY=YOUR_API_KEY
codex

OpenCodeOpenCode

~/.config/opencode/config.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "luno": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Luno",
      "options": {
        "baseURL": "https://api.luno.codes/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "claude-opus-4-8": { "name": "Claude Opus 4.8" },
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" },
        "gpt-4o": { "name": "GPT-4o" }
      }
    }
  }
}

CursorCursor

Impostazioni → Modelli → OpenAI API Key:

Base URL: https://api.luno.codes/v1
API Key:  YOUR_API_KEY

OpenAI Python SDKOpenAI Python SDK

Python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.luno.codes/v1",
    api_key="YOUR_API_KEY"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)

Anthropic Python SDKAnthropic Python SDK

Python
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.luno.codes/v1",
    api_key="YOUR_API_KEY"
)

message = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}]
)
print(message.content[0].text)
Funziona con qualsiasi strumento che accetti una Base URL + una chiave API. Basta puntarlo su https://api.luno.codes/v1

Modelli

Tutti i modelli disponibili tramite un unico endpoint. Clicca su qualsiasi ID modello per copiarlo.

Elenca i modelli
curl https://api.luno.codes/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

ClaudeClaude

claude-fable-5

Il più potente — ammiraglia

claude-opus-4-8

Il più capace, per compiti complessi

claude-opus-4-7

Flagship precedente

claude-opus-4-6

Ragionamento avanzato

claude-opus-4-5

Opus bilanciato

claude-sonnet-5

Il modello Sonnet più recente — anteprima

claude-sonnet-4-6

Miglior equilibrio velocità/qualità

claude-sonnet-4-5

Generazione veloce

claude-sonnet-4

Sonnet leggero

claude-haiku-4-5

Ultra-veloce

GPTGPT

gpt-5.6-sol

Ragionamento profondo

gpt-5.6-terra

Flagship bilanciato

gpt-5.6-luna

Veloce ed economico

gpt-5.5

Flagship precedente

gpt-5.4

Flagship precedente

gpt-5.3-codex

Coding agentico

gpt-5.2-codex

Coding a lungo termine

gpt-5.1

Ragionamento adattivo

gpt-4o

Multimodale

gpt-4o-mini

Veloce ed economico

GeminiGemini

gemini-3.5-flash

Il più veloce, miglior rapporto qualità-prezzo

gemini-3.1-pro

Il Gemini più capace

gemini-3.1-flash

Leggero e veloce

Endpoint

POST/v1/chat/completions

Formato OpenAI — funziona con tutti i modelli

POST/v1/messages

Formato Anthropic — modelli Claude (Claude Code, SDK)

Streaming

Aggiungi "stream": true per l'output in tempo reale tramite Server-Sent Events.

cURL (SSE)
curl https://api.luno.codes/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "stream": true,
    "messages": [{"role": "user", "content": "Explain SSE briefly"}]
  }'
Node.js
const res = await fetch("https://api.luno.codes/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "claude-sonnet-4-6",
    stream: true,
    messages: [{ role: "user", content: "Hello" }]
  })
});

const reader = res.body.getReader();
const decoder = new TextDecoder();
while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  process.stdout.write(decoder.decode(value));
}

Errori

Codici di stato HTTP standard con corpi di errore in JSON.

401
auth_error

Chiave API non valida o mancante

402
insufficient_funds

Budget di token esaurito per questo periodo

429
rate_limit_exceeded

Troppe richieste — rallenta

502
upstream_error

Fornitore del modello temporaneamente non disponibile

Formato della risposta di errore
{
  "error": {
    "message": "Invalid API key provided.",
    "type": "auth_error",
    "code": 401
  }
}