LobsterPod Documentation

curl -X POST https://api.lobsterpod.dev/api/v1/consumers/register \
  -H "Content-Type: application/json" \
  -d '{"name": "my-app", "email": "[email protected]"}'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.lobsterpod.dev/v1",  # ← point to LobsterPod
    api_key="lp_live_YOUR_KEY",                  # ← your LobsterPod key
)

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

curl https://api.lobsterpod.dev/v1/chat/completions \
  -H "Authorization: Bearer lp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.lobsterpod.dev/v1",
  apiKey: "lp_live_YOUR_KEY",
});

const response = await client.chat.completions.create({
  model: "claude-sonnet-4-20250514",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(response.choices[0].message.content);

curl -X POST https://api.lobsterpod.dev/api/v1/consumers/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-app",
    "email": "[email protected]"
  }'

{
  "id": "cons_abc123",
  "api_key": "lp_live_xxxxxxxxxxxxxxxxxxxxxxxx",
  "name": "my-app",
  "status": "active"
}

curl https://api.lobsterpod.dev/v1/chat/completions \
  -H "Authorization: Bearer lp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Explain distributed computing in one paragraph."}
    ],
    "temperature": 0.7,
    "max_tokens": 500
  }'

stream = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[{"role": "user", "content": "Write a haiku about distributed computing"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

curl -N https://api.lobsterpod.dev/v1/chat/completions \
  -H "Authorization: Bearer lp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

curl https://api.lobsterpod.dev/v1/models

response = client.chat.completions.create(
    model="lobsterpod/swarm",
    messages=[{
        "role": "user",
        "content": "Review this codebase for security vulnerabilities"
    }],
    extra_body={
        "swarm_config": {
            "preset": "security-audit"
        }
    }
)

{
  "error": {
    "message": "Rate limit exceeded. Retry after 30 seconds.",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}

curl https://api.lobsterpod.dev/v1/billing/usage \
  -H "Authorization: Bearer lp_live_YOUR_KEY"

openclaw skills install lobsterpod-contributor

curl -X POST https://api.lobsterpod.dev/api/v1/contributors/register \
  -H "Content-Type: application/json" \
  -d '{
    "node_alias": "my-claw-01",
    "models": ["gpt-4o", "claude-sonnet-4-20250514"],
    "status": "available"
  }'

openclaw config set skills.entries.lobsterpod-contributor.config.contributorToken "lpc_YOUR_TOKEN"
openclaw config set skills.entries.lobsterpod-contributor.config.masterEndpoint "https://api.lobsterpod.dev"
openclaw config set skills.entries.lobsterpod-contributor.config.nodeAlias "my-claw-01"

{
  "skills": {
    "entries": {
      "lobsterpod-contributor": {
        "enabled": true,
        "config": {
          "contributorToken": "lpc_YOUR_TOKEN",
          "masterEndpoint": "https://api.lobsterpod.dev",
          "nodeAlias": "my-claw-01",
          "allowedModels": ["gpt-4o", "claude-sonnet-4-20250514"],
          "maxConcurrent": 5,
          "maxTokensPerHour": 500000,
          "monthlyCostCeiling": 50.00
        }
      }
    }
  }
}

curl https://api.lobsterpod.dev/api/v1/contributors/me/earnings \
  -H "Authorization: Bearer lpc_YOUR_TOKEN"