🚀 LingKong AI API

{
  "contents": [{"parts": [{"text": "解释量子纠缠现象"}]}],
  "generationConfig": {
    "thinkingConfig": {
      "thinkingLevel": "high",
      "includeThoughts": true
    },
    "maxOutputTokens": 1024
  }
}

{
  "contents": [{"parts": [{"text": "查询北京和上海的天气"}]}],
  "tools": [{
    "functionDeclarations": [{
      "name": "get_weather",
      "description": "获取指定城市的天气信息",
      "parameters": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "description": "城市名称"
          }
        },
        "required": ["location"]
      }
    }]
  }],
  "toolConfig": {
    "functionCallingConfig": {
      "mode": "AUTO"  // AUTO | ANY | NONE
    }
  }
}

{
  "contents": [{
    "role": "user",
    "parts": [
      {"text": "描述这张图片的内容"},
      {
        "inlineData": {
          "mimeType": "image/png",
          "data": "iVBORw0KGgoAAAANSUhEUgAA..."  // Base64
        }
      }
    ]
  }]
}

{
  "contents": [{
    "role": "user",
    "parts": [
      {"text": "Transcribe this audio and describe what you hear"},
      {
        "inlineData": {
          "mimeType": "audio/wav",
          "data": "UklGRi4AAABXQVZFZm10..."  // Base64 WAV (16kHz mono)
        }
      }
    ]
  }],
  "generationConfig": {
    "maxOutputTokens": 1024
  }
}

{
  "contents": [
    {"role": "user", "parts": [{"text": "我想学 Python"}]},
    {
      "role": "model",
      "parts": [
        {"text": "Python 是很好的选择..."},
        {"thoughtSignature": "EoQDCAISOg..."}  // 上一轮的签名
      ]
    },
    {"role": "user", "parts": [{"text": "有什么推荐的资源吗？"}]}
  ]
}

{
  "crypto_available": true,
  "server_keys_loaded": true,
  "registered_clients": 3,
  "algorithms": {
    "key_exchange": "X25519",
    "signature": "Ed25519",
    "encryption": "ChaCha20-Poly1305",
    "kdf": "HMAC-SHA256"
  }
}

{
  "signing_public": "base64_ed25519_public_key",
  "x25519_public": "base64_x25519_public_key",
  "user_id": "server_unique_id"
}

from lingkong_client import LingKongClient

# 1. 创建客户端 (自动获取服务器公钥)
client = LingKongClient(
    base_url="https://lingkong.xyz",
    api_key="sk-your-api-key"
)

# 2. 发送加密请求
response = client.generate_content(
    prompt="你好，请介绍一下端到端加密",
    encrypted=True  # 启用端到端加密
)

# 3. 获取解密后的响应
print(response.text)

# 备份客户端密钥 (重要!)
keys = client.export_keys()
print(f"User ID: {keys['user_id']}")
# 安全存储 keys['signing_key'] 和 keys['x25519_key']

import lingkong_crypto as lk
import requests
import json

# 1. 生成客户端密钥对
client_keys = lk.UserKeys()
print(f"Client ID: {client_keys.user_id()}")

# 2. 获取服务器公钥
resp = requests.get("https://lingkong.xyz/crypto/public-key")
server_x25519_public = lk.base64_decode(resp.json()["x25519_public"])

# 3. 构建请求
request_body = {
    "contents": [{"parts": [{"text": "你好"}]}],
    "generationConfig": {"maxOutputTokens": 256}
}

# 4. 加密请求 (KEM + ChaCha20)
encrypted_req = lk.EncryptedRequest.create(
    json.dumps(request_body),
    client_keys,
    bytes(server_x25519_public)
)

# 5. 发送加密请求
resp = requests.post(
    "https://lingkong.xyz/v1beta/models/gemma:generateContentEncrypted",
    json=json.loads(encrypted_req.to_json())
)

# 6. 解密响应 (使用共享密钥)
# ... 响应解密逻辑

{
  "ephemeral_public": "base64_x25519_临时公钥",
  "ciphertext": "base64_chacha20_加密内容",
  "nonce": "base64_12字节随机数",
  "sender_id": "base64_ed25519_签名公钥",
  "signature": "base64_ed25519_签名",
  "timestamp": 1735862400
}

{
  "ciphertext": "base64_chacha20_加密响应",
  "nonce": "base64_12字节随机数",
  "signature": "base64_服务器签名",
  "timestamp": 1735862401
}

import lingkong_crypto as lk

# 1. 初始化会话 (发起方)
shared_secret = ...  # 从 KEM 获取
peer_dh_public = ...  # 对方 DH 公钥

session = lk.DoubleRatchetSession.init_as_initiator(
    shared_secret,
    peer_dh_public
)

# 2. 加密消息 (发送)
ciphertext, nonce, current_dh = session.encrypt(b"Hello!")

# 3. 解密消息 (接收)
plaintext = session.decrypt(
    ciphertext,
    nonce,
    sender_dh_public
)

# 4. 查看会话状态
print(f"发送消息数: {session.send_count}")
print(f"接收消息数: {session.recv_count}")
print(f"DH 棘轮次数: {session.dh_ratchet_count}")

# 5. 保存会话状态
state_json = session.export_state()
# 存储到安全位置...

# 6. 恢复会话
restored = lk.DoubleRatchetSession.import_state(state_json)

{
  "error": {
    "message": "contents 不能为空",
    "code": "400"
  }
}