SilvaMux Unified Entry

An optional cross-protocol unified entry. It accepts the OpenAI Chat format, picks the upstream automatically based on model, and normalizes responses, SSE, and errors into the OpenAI Chat format. Useful when you want to call models across protocols through a single endpoint.

POST/api/v0/chat/completions

SilvaMux 统一入口

可选的跨协议统一入口。按 model 选择上游，并将响应、SSE 和错误统一为 OpenAI Chat 格式。

Bearer API KeyUse the Authorization: Bearer sk_live_... header; x-api-key is also supported.

Confirm the model call name firstFirst filter models that support this endpoint format on the Models page, then open a model detail page to copy its call name. Your account's final availability also depends on organization permissions.

Request structure

The section below confirms the method, URL and authentication scheme. It is an HTTP structure snippet, not a standalone runnable example.

HTTP

POST https://www.silvamux.com/api/v0/chat/completions
Authorization: Bearer $SILVAMUX_API_KEY
Content-Type: application/json

Request body

application/json · OpenAIChatRequest · Required

Field	Type	Required	Description
`max_tokens`	integer	No	—
`messages`	array<Message>	Yes	—
`messages.content`	string \| array<FreeFormObject>	Yes	—
`messages.role`	string (system \| user \| assistant \| tool)	Yes	—
`model`	string	Yes	SilvaMux 模型 id 或 alias。
`stream`	boolean	No	Default: false
`temperature`	number	No	—
`tools`	array<FreeFormObject>	No	—

Response

`200`OpenAI Chat JSON 或 SSE 响应。

application/json · OpenAIChatResponse

Field	Type	Required	Description
`choices`	array<FreeFormObject>	Yes	—
`id`	string	Yes	—
`model`	string	No	—
`object`	string	No	—
`usage`	FreeFormObject	No	—

`default`OpenAI 兼容错误。

application/json · OpenAIError

Field	Type	Required	Description
`error`	object	Yes	—
`error.code`	string \| integer	No	—
`error.message`	string	Yes	—
`error.type`	string	No	—

Examples

curl https://www.silvamux.com/api/v0/chat/completions \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m2.5",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

# pip install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["SILVAMUX_API_KEY"],
    base_url="https://www.silvamux.com/api/v0",
)

response = client.chat.completions.create(
    model="minimax-m2.5",
    messages=[{"role": "user", "content": "Hello"}],
)

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

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.SILVAMUX_API_KEY,
  baseURL: "https://www.silvamux.com/api/v0",
});

const response = await client.chat.completions.create({
  model: "minimax-m2.5",
  messages: [{ role: "user", content: "Hello" }],
});

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

// Standard library only
package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    payload := []byte(`{
        "model": "minimax-m2.5",
        "messages": [{"role": "user", "content": "Hello"}]
    }`)

    req, err := http.NewRequest("POST", "https://www.silvamux.com/api/v0/chat/completions", bytes.NewReader(payload))
    if err != nil {
        panic(err)
    }
    req.Header.Set("Authorization", "Bearer "+os.Getenv("SILVAMUX_API_KEY"))
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

The unified entry normalizes request and response structures. When you need vendor-specific fields, events, or response shapes, prefer the corresponding vendor protocol compatible entry.