OpenAI Compatible API

Accepts the OpenAI Chat Completions request format and preserves the matching response, SSE, and error structures. Recommended for projects using the OpenAI SDK and for most new projects — existing OpenAI SDK code migrates by changing only the base URL and API key.

POST/api/v1/chat/completions

OpenAI Chat Completions

OpenAI Chat Completions 兼容入口，额外字段按模型能力透传。

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/v1/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/v1/chat/completions \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m2.5",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant"},
      {"role": "user", "content": "Hello"}
    ],
    "stream": false
  }'

# 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/v1",
)

response = client.chat.completions.create(
    model="minimax-m2.5",
    messages=[
        {"role": "system", "content": "You are a helpful assistant"},
        {"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/v1",
});

const response = await client.chat.completions.create({
  model: "minimax-m2.5",
  messages: [
    { role: "system", content: "You are a helpful assistant" },
    { 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": "system", "content": "You are a helpful assistant"},
            {"role": "user", "content": "Hello"}
        ],
        "stream": false
    }`)

    req, err := http.NewRequest("POST", "https://www.silvamux.com/api/v1/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))
}

Response (OpenAI format):

{
  "id": "chatcmpl-xxxx",
  "choices": [
    {
      "message": {"role": "assistant", "content": "Hello! How can I help you today?"},
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 20, "completion_tokens": 15, "total_tokens": 35}
}

The compatible entry passes through extra fields of the corresponding protocol. See Overview for streaming and multimodal input.