Volcengine Compatible

Compatible with the Volcengine Ark OpenAI-compatible API (v3 protocol), usable for Doubao Seed series models and other models that follow the Volcengine v3 protocol.

POST/api/v3/chat/completions

Volcengine 兼容

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/v3/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`Volcengine 兼容错误。

application/json · VolcengineError

Field	Type	Required	Description
`error`	FreeFormObject	No	—

Examples

curl https://www.silvamux.com/api/v3/chat/completions \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-2.0-pro",
    "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/v3",
)

response = client.chat.completions.create(
    model="doubao-seed-2.0-pro",
    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/v3",
});

const response = await client.chat.completions.create({
  model: "doubao-seed-2.0-pro",
  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": "doubao-seed-2.0-pro",
        "messages": [{"role": "user", "content": "Hello"}]
    }`)

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

https://www.silvamux.com/api/v3 is the /api/v3 path under the access domain, routing to /api/v3/chat/completions. Authentication uses the SilvaMux API key, not Volcengine AK/SK.