Swfte Connect API Reference Guide

curl https://connect.swfte.com/v2/gateway/chat/completions \
  -H "Authorization: Bearer sk-swfte-your-key-here" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai:gpt-5", "messages": [{"role": "user", "content": "Hello"}]}'

https://connect.swfte.com/v2/gateway

POST /v2/gateway/chat/completions

{
  "model": "openai:gpt-5",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "What is the capital of France?"}
  ],
  "max_tokens": 256,
  "temperature": 0.7,
  "top_p": 1.0,
  "n": 1,
  "stream": false,
  "stop": null,
  "presence_penalty": 0,
  "frequency_penalty": 0,
  "tools": null,
  "tool_choice": null,
  "swfte_options": {
    "fallback_models": ["anthropic:claude-sonnet-4"],
    "routing": "lowest_latency",
    "timeout_ms": 30000
  }
}

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1711648000,
  "model": "gpt-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "The capital of France is Paris."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 8,
    "total_tokens": 33
  },
  "swfte_metadata": {
    "cost": 0.000495,
    "latency_ms": 234,
    "provider": "openai",
    "cached": false,
    "request_id": "req_xyz789"
  }
}

curl https://connect.swfte.com/v2/gateway/chat/completions \
  -H "Authorization: Bearer sk-swfte-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "openai:gpt-5", "messages": [{"role": "user", "content": "Hello"}], "stream": true}'

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

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

data: [DONE]

POST /v2/gateway/embeddings

{
  "model": "openai:text-embedding-3-large",
  "input": ["First text to embed", "Second text to embed"],
  "encoding_format": "float",
  "dimensions": 1536
}

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "embedding": [0.0023, -0.0091, 0.0154, ...],
      "index": 0
    }
  ],
  "model": "text-embedding-3-large",
  "usage": {
    "prompt_tokens": 12,
    "total_tokens": 12
  }
}

GET /v2/gateway/models

{
  "object": "list",
  "data": [
    {
      "id": "openai:gpt-5",
      "object": "model",
      "provider": "openai",
      "name": "GPT-5",
      "type": "TEXT_GENERATION",
      "context_window": 128000,
      "max_output_tokens": 16384,
      "pricing": {
        "input_per_1m_tokens": 5.00,
        "output_per_1m_tokens": 15.00
      }
    }
  ]
}

GET /api/dashboard/api-keys

{
  "keys": [
    {
      "id": "key_abc123",
      "name": "production-backend",
      "keyPrefix": "sk-swfte-abc...",
      "enabled": true,
      "totalRequests": 15234,
      "totalTokens": 4521000,
      "totalCost": 67.83,
      "createdAt": "2026-01-15T10:00:00Z",
      "lastUsedAt": "2026-03-28T14:30:00Z",
      "status": "healthy"
    }
  ],
  "count": 1,
  "activeCount": 1,
  "totalRequests": 15234
}

POST /api/api-keys

{
  "name": "my-new-key",
  "scope": "all",
  "rateLimit": {
    "requestsPerMinute": 60
  }
}

DELETE /api/api-keys/{keyId}

GET /api/billing/credits

{
  "balance": 142.50,
  "currency": "USD",
  "low_balance_warning": false,
  "auto_reload_enabled": true,
  "free_tier": {
    "has_free_tier": true,
    "limit": 10.00,
    "remaining": 3.50
  }
}

GET /api/billing/summary

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded for key key_abc123. Limit: 60 req/min.",
    "type": "rate_limit_error",
    "retry_after": 12
  }
}

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1711648060