SACTL Gateway API

{
  "error": {
    "code": "key_invalid",
    "message": "virtual key is invalid or revoked",
    "trace_id": "01JX7W3Z5A8M9E2Q1P4K6R8TVB"
  }
}

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "Hello, Claude." }
  ]
}

HTTP/1.1 200 OK
X-SACTL-Usage-Prompt-Tokens: 12
X-SACTL-Usage-Completion-Tokens: 28
X-SACTL-Usage-Cost-USD: 0.000336
X-SACTL-Budget-Remaining-USD: 49.832104

{
  "id": "msg_01AbCdEfGhIjKlMnOpQrStUv",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [
    { "type": "text", "text": "Hello! How can I help you today?" }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 12,
    "output_tokens": 28
  }
}

curl https://api.sactl.ai/v1/messages \
  -H "Authorization: Bearer YOUR_VK" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello, Claude." }
    ]
  }'

{
  "model": "claude-sonnet-4-6",
  "messages": [
    { "role": "system", "content": "You are a helpful assistant." },
    { "role": "user", "content": "Write a haiku about Go channels." }
  ],
  "max_tokens": 256,
  "temperature": 0.7
}

{
  "id": "chatcmpl-0A1B2C3D4E5F",
  "object": "chat.completion",
  "created": 1745145600,
  "model": "claude-sonnet-4-6",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Silent channels hum,\nGoroutines pass gifts in dark,\nSelect waits for dawn."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 22,
    "completion_tokens": 31,
    "total_tokens": 53
  }
}

curl https://api.sactl.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_VK" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      { "role": "system", "content": "You are a helpful assistant." },
      { "role": "user", "content": "Write a haiku about Go channels." }
    ],
    "max_tokens": 256,
    "temperature": 0.7
  }'

curl https://api.sactl.ai/v1/completions \
  -H "Authorization: Bearer YOUR_VK" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-3.5-turbo-instruct",
    "prompt": "Say hello in three languages.",
    "max_tokens": 64
  }'

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023, -0.0091, 0.0412, /* ... 1536 floats */]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 7,
    "total_tokens": 7
  }
}

curl https://api.sactl.ai/v1/embeddings \
  -H "Authorization: Bearer YOUR_VK" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "The quick brown fox jumps over the lazy dog."
  }'

{
  "data": [
    { "type": "model", "id": "claude-opus-4-7",     "display_name": "Claude Opus 4.7",   "created_at": "2025-09-29T00:00:00Z" },
    { "type": "model", "id": "claude-opus-4-6",     "display_name": "Claude Opus 4.6",   "created_at": "2025-08-05T00:00:00Z" },
    { "type": "model", "id": "claude-sonnet-4-6",   "display_name": "Claude Sonnet 4.6", "created_at": "2025-07-10T00:00:00Z" },
    { "type": "model", "id": "claude-haiku-4-5",    "display_name": "Claude Haiku 4.5",  "created_at": "2025-05-03T00:00:00Z" }
  ],
  "has_more": false,
  "first_id": "claude-opus-4-7",
  "last_id": "claude-haiku-4-5"
}
# GPT 模型已加入此列表(与 VK allowed_models 取交集)。Gemini 上游接入后自动出现。

curl https://api.sactl.ai/v1/models \
  -H "Authorization: Bearer YOUR_VK"

{
  "id": "file_01AbCdEfGhIjKlMnOpQrStUv",
  "type": "file",
  "filename": "contract.pdf",
  "mime_type": "application/pdf",
  "size_bytes": 183204,
  "created_at": "2026-04-20T08:12:31.441Z",
  "downloadable": false
}

curl https://api.sactl.ai/v1/files \
  -H "Authorization: Bearer YOUR_VK" \
  -F "[email protected];type=application/pdf" \
  -F "purpose=context"

{
  "data": [
    { "id": "file_01AbCd...", "filename": "contract.pdf", "size_bytes": 183204, "mime_type": "application/pdf", "created_at": "2026-04-20T08:12:31.441Z" }
  ],
  "has_more": false,
  "first_id": "file_01AbCd...",
  "last_id": "file_01AbCd..."
}

curl "https://api.sactl.ai/v1/files?limit=20" \
  -H "Authorization: Bearer YOUR_VK"

curl https://api.sactl.ai/v1/files/file_01AbCdEfGhIjKlMnOpQrStUv \
  -H "Authorization: Bearer YOUR_VK"

{
  "id": "file_01AbCdEfGhIjKlMnOpQrStUv",
  "type": "file_deleted"
}

curl -X DELETE https://api.sactl.ai/v1/files/file_01AbCdEfGhIjKlMnOpQrStUv \
  -H "Authorization: Bearer YOUR_VK"

{
  "requests": [
    {
      "custom_id": "job-001",
      "params": {
        "model": "claude-haiku-4-5",
        "max_tokens": 256,
        "messages": [ { "role": "user", "content": "Summarize Go channels." } ]
      }
    },
    {
      "custom_id": "job-002",
      "params": {
        "model": "claude-haiku-4-5",
        "max_tokens": 256,
        "messages": [ { "role": "user", "content": "What is GCRA?" } ]
      }
    }
  ]
}

{
  "id": "msgbatch_01Wx9...",
  "type": "message_batch",
  "processing_status": "in_progress",
  "request_counts": { "processing": 2, "succeeded": 0, "errored": 0, "canceled": 0, "expired": 0 },
  "ended_at": null,
  "created_at": "2026-04-20T08:12:31.441Z",
  "expires_at": "2026-04-21T08:12:31.441Z",
  "cancel_initiated_at": null,
  "results_url": null
}

curl https://api.sactl.ai/v1/messages/batches \
  -H "Authorization: Bearer YOUR_VK" \
  -H "Content-Type: application/json" \
  -d @batch.json

curl "https://api.sactl.ai/v1/messages/batches?limit=20" \
  -H "Authorization: Bearer YOUR_VK"

{
  "id": "msgbatch_01Wx9...",
  "processing_status": "ended",
  "request_counts": { "processing": 0, "succeeded": 2, "errored": 0, "canceled": 0, "expired": 0 },
  "ended_at": "2026-04-20T08:14:02.112Z",
  "results_url": "https://api.sactl.ai/v1/messages/batches/msgbatch_01Wx9.../results"
}

curl https://api.sactl.ai/v1/messages/batches/msgbatch_01Wx9... \
  -H "Authorization: Bearer YOUR_VK"

{"custom_id":"job-001","result":{"type":"succeeded","message":{"id":"msg_...","content":[...],"usage":{...}}}}
{"custom_id":"job-002","result":{"type":"succeeded","message":{"id":"msg_...","content":[...],"usage":{...}}}}

curl https://api.sactl.ai/v1/messages/batches/msgbatch_01Wx9.../results \
  -H "Authorization: Bearer YOUR_VK"

curl -X POST https://api.sactl.ai/v1/messages/batches/msgbatch_01Wx9.../cancel \
  -H "Authorization: Bearer YOUR_VK"

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "ok",
  "redis": "ok",
  "vault": "ok",
  "version": "0.9.3",
  "commit": "a1b2c3d",
  "uptime_seconds": 84221
}

curl https://api.sactl.ai/health

# HELP rl_reject_total Number of requests rejected by rate limiter
# TYPE rl_reject_total counter
rl_reject_total{dim="tenant"} 12
rl_reject_total{dim="vk"} 3
rl_reject_total{dim="vk_model"} 1
rl_reject_total{dim="vk_ip"} 0

# HELP forward_request_duration_seconds Request duration histogram
# TYPE forward_request_duration_seconds histogram
forward_request_duration_seconds_bucket{route="/v1/messages",le="0.5"} 4821
forward_request_duration_seconds_bucket{route="/v1/messages",le="1"} 5910
forward_request_duration_seconds_bucket{route="/v1/messages",le="+Inf"} 6024

# HELP upstream_5xx_total Upstream 5xx responses
# TYPE upstream_5xx_total counter
upstream_5xx_total{upstream="anthropic"} 2

# HELP audit_worm_append_total WORM audit log appends
# TYPE audit_worm_append_total counter
audit_worm_append_total{event="message.ok"} 5932
audit_worm_append_total{event="file.uploaded"} 18

curl https://api.sactl.ai/metrics