OpenAI 原生格式（模型列表）

返回当前 API Key 可以使用的模型。模型是否可用由租户权限、渠道状态和余额共同决定。

请求

GET /v1/models
Authorization: Bearer sk-your-api-key

接口地址由 API_BASE_URL 和 /models 拼接得到：

https://www.walmind.cn/v1/models

调用示例

cURL

curl -X GET "https://www.walmind.cn/v1/models" \
  -H "Authorization: Bearer $API_KEY"

JavaScript

const response = await fetch('https://www.walmind.cn/v1/models', {
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
});

const data = await response.json();
console.log(data);

Python

import os
import requests

response = requests.get(
    "https://www.walmind.cn/v1/models",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
response.raise_for_status()
print(response.json())

Go

package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://www.walmind.cn/v1/models", nil)
    req.Header.Set("Authorization", "Bearer "+os.Getenv("API_KEY"))

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

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

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ListModels {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://www.walmind.cn/v1/models"))
            .header("Authorization", "Bearer " + System.getenv("API_KEY"))
            .GET()
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

响应字段

字段	类型	说明
object	string	固定为 list
data	array	模型对象列表
data[].id	string	请求时使用的模型 ID
data[].object	string	固定为 model
data[].created	integer	Unix 时间戳
data[].owned_by	string	模型提供方或平台标识

响应示例：

{
  "object": "list",
  "data": [
    {
      "id": "your-model-id",
      "object": "model",
      "created": 1710000000,
      "owned_by": "platform"
    }
  ]
}

模型 ID 必须使用接口返回的值。不要直接使用上游厂商的模型名称，除非该名称也出现在列表中。

按协议返回模型列表

统一入口通常默认返回 OpenAI 模型列表。如果客户端使用原生协议，网关可能根据请求头选择对应的返回结构：

请求方式	返回格式
普通 Bearer Token 请求	OpenAI 模型列表格式
同时携带 x-api-key 和 anthropic-version	Claude 模型列表格式（以部署支持为准）
携带 x-goog-api-key 或 key 查询参数	Gemini 模型列表格式（以部署支持为准）

如果客户端固定使用某一种协议，建议直接阅读该协议对应的模型列表页面，并保持模型列表请求和模型调用请求使用同一套鉴权方式。平台实际启用的协议以当前部署配置为准。