快速开始

本指南帮助你在 5 分钟内发出第一个 API 请求。

1. 获取 API Key

注册账号后，在控制台的 API Keys 页面创建一个 API Key。Key 只在创建时显示一次，请妥善保存。

API Key 格式为 sk_live_ 开头的字符串。

2. 发送第一个请求

SilvaMux 的对话 API 完全兼容 OpenAI 格式。如果你已有使用 OpenAI SDK 的代码，只需修改 base URL 和 API Key 即可。

curl

curl https://silvamux.tingyutech.com/api/v1/chat/completions \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aliyun/kimi-k2.5",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ]
  }'

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="sk_live_YOUR_API_KEY",
    base_url="https://silvamux.tingyutech.com/api/v1",
)

response = client.chat.completions.create(
    model="aliyun/kimi-k2.5",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)

print(response.choices[0].message.content)

Node.js (OpenAI SDK)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk_live_YOUR_API_KEY",
  baseURL: "https://silvamux.tingyutech.com/api/v1",
});

const response = await client.chat.completions.create({
  model: "aliyun/kimi-k2.5",
  messages: [{ role: "user", content: "用一句话介绍你自己" }],
});

console.log(response.choices[0].message.content);

3. 流式输出

设置 stream: true 即可获得流式响应：

curl https://silvamux.tingyutech.com/api/v1/chat/completions \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aliyun/kimi-k2.5",
    "messages": [{"role": "user", "content": "写一首五言绝句"}],
    "stream": true
  }'

流式响应格式为 Server-Sent Events (SSE)，每个事件的 data 字段包含一个 JSON chunk。最后一个事件为 data: [DONE]。

4. 使用 Anthropic 格式

如果你更熟悉 Anthropic 的 Messages API，SilvaMux 同样支持：

curl https://silvamux.tingyutech.com/api/anthropic/v1/messages \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aliyun/kimi-k2.5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'