Documentation API

Intégrez l'API Lumia Automation en 5 minutes

L'API Lumia Automation est 100% compatible avec le SDK Anthropic. Changez uniquement la base_url et votre clé API.

Authentification

Passez votre clé API dans le header Authorization.

Authorization: Bearer sk-lm-...

Créez vos clés depuis le dashboard → Clés API.

Endpoint

POST https://lumia-api.fly.dev/v1/messages

# Base URL
https://lumia-api.fly.dev

Exemples

curl https://lumia-api.fly.dev/v1/messages \
  -H "Authorization: Bearer $LUMIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Claude Code & IDE

Lumia Automation est compatible avec Claude Code, VS Code, Cursor et JetBrains.

Claude Code — variables d'environnement

export ANTHROPIC_BASE_URL="https://lumia-api.fly.dev"
export ANTHROPIC_API_KEY="sk-..."

claude

Claude Code — settings.json (persistant)

// ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://lumia-api.fly.dev",
    "ANTHROPIC_API_KEY": "sk-..."
  }
}

VS Code / Cursor / JetBrains

// .vscode/settings.json
{
  "claude.apiKey": "sk-...",
  "claude.baseUrl": "https://lumia-api.fly.dev"
}

Agent IA — OpenClaw

Configurez OpenClaw pour utiliser Lumia Automation comme fournisseur Anthropic. Copiez la configuration ci-dessous dans votre fichier openclaw.json, remplacez la clé API par la vôtre (disponible dans Dashboard → Clés API), puis redémarrez OpenClaw.

Étape 1 — Fichier de configuration openclaw.json

// openclaw.json — section "models.providers"
{
  "models": {
    "providers": {
      "anthropic": {
        "baseUrl": "https://lumia-api.fly.dev/v1",
        "apiKey": "sk-...",
        "api": "anthropic-messages",
        "authHeader": true,
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "api": "anthropic-messages",
            "contextWindow": 200000,
            "maxTokens": 16384,
            "input": ["text", "image"]
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "api": "anthropic-messages",
            "contextWindow": 200000,
            "maxTokens": 16384,
            "input": ["text", "image"]
          },
          {
            "id": "claude-opus-4-8",
            "name": "Claude Opus 4.8",
            "api": "anthropic-messages",
            "contextWindow": 200000,
            "maxTokens": 16384,
            "input": ["text", "image"]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4-6"
    }
  }
}

Alternative — Variables d'environnement

# Alternative : variables d'environnement
export ANTHROPIC_API_KEY="sk-..."
export ANTHROPIC_BASE_URL="https://lumia-api.fly.dev"

openclaw start

SaaS & App mobile

Intégrez Lumia Automation dans votre app iOS, Android ou SaaS.

iOS — Swift

import Foundation

var request = URLRequest(url: URL(string: "https://lumia-api.fly.dev/v1/messages")!)
request.httpMethod = "POST"
request.setValue("Bearer sk-...", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONSerialization.data(withJSONObject: [
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "messages": [["role": "user", "content": "Hello!"]]
])

URLSession.shared.dataTask(with: request) { data, _, _ in
  if let data, let text = String(data: data, encoding: .utf8) { print(text) }
}.resume()

Android — Kotlin

import okhttp3.*
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.RequestBody.Companion.toRequestBody

val json = """{"model":"claude-sonnet-4-6","max_tokens":1024,"messages":[{"role":"user","content":"Hello!"}]}"""
val request = Request.Builder()
  .url("https://lumia-api.fly.dev/v1/messages")
  .post(json.toRequestBody("application/json".toMediaType()))
  .addHeader("Authorization", "Bearer sk-...")
  .build()

OkHttpClient().newCall(request).execute().use { println(it.body?.string()) }

Modèles disponibles

API / SaaS

Clients utilisant le header x-user-id (intégration dashboard).

ModèleInput / 1M tokensOutput / 1M tokens
Claude Haiku 4.5
claude-haiku-4-5-20251001
$1$5
Claude Sonnet 4.6
claude-sonnet-4-6
$3$15
Claude Opus 4.6
claude-opus-4-6
$5$25
Claude Opus 4.7
claude-opus-4-7
$5$25
Claude Opus 4.8
claude-opus-4-8
$5$25

Claude Code, OpenClaw & API

Tous les clients externes (Claude Code, OpenClaw, SDK Anthropic, apps custom). Détection automatique.

ModèleInput / 1M tokensOutput / 1M tokens
Claude Haiku 3
claude-3-haiku-20240307
$1$5
Claude Haiku 4.5
claude-haiku-4-5-20251001
$1$5
Claude Sonnet 4
claude-sonnet-4-20250514
$3$15
Claude Sonnet 4.5
claude-sonnet-4-5-20250929
$3$15
Claude Sonnet 4.6
claude-sonnet-4-6
$3$15
Claude Opus 4
claude-opus-4-20250514
$15$75
Claude Opus 4.1
claude-opus-4-1-20250805
$15$75
Claude Opus 4.5
claude-opus-4-5-20251101
$5$25
Claude Opus 4.6
claude-opus-4-6
$5$25
Claude Opus 4.7
claude-opus-4-7
$5$25
Claude Opus 4.8
claude-opus-4-8
$5$25

Codes d'erreur

CodeMessageCause
401Missing API keyAuthorization header missing
401Invalid API keyInvalid or revoked key
402Insufficient creditsBalance ≤ 0
502Missing usage dataUpstream response without usage
503Service unavailableInfrastructure unavailable
504Upstream unavailableAll providers temporarily down