万界文档中心

Appearance

万界方舟接口文档 ​

接入流程说明 ​

  • 访问万界方舟，通过手机号登录，在“模型广场”中，点击模型名称进行模型复制。

  • 获取密钥：进入万界方舟 API Key ，找到 API KEY 点击一键复制按钮。

  • 模型说明：模型广场展示所有已授权模型，其他模型服务需要和运营人员进行授权报备。

接口基础信息 ​

  • Base URL：

OpenAI ：https://maas-openapi.wanjiedata.com/api/v1

Gemini ：https://maas-openapi.wanjiedata.com/api

Anthropic ：https://maas-openapi.wanjiedata.com/api/anthropic

获取模型列表 ​

  • 获取已经授权的模型列表（不含 Anthropic 端侧模型）
shell
curl https://maas-openapi.wanjiedata.com/api/v1/models \
  -H "Authorization: Bearer $API_KEY"
python
import requests
API_KEY = "<你的 API KEY>"
url = "https://maas-openapi.wanjiedata.com/api/v1/models"
headers = {
    "Authorization": f"Bearer {API_KEY}"
}
response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json())
javascript
import axios from 'axios';

const apiKey = '<你的 API KEY>';

async function getModels() {
  try {
    const response = await axios.get('https://maas-openapi.wanjiedata.com/api/v1/models', {
      headers: { Authorization: `Bearer ${apiKey}` }
    });
    console.log('模型列表:', response.data);
  } catch (error) {
    console.error('请求失败:', error.response ? error.response.data : error.message);
  }
}

getModels();
csharp
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
   static async Task Main()
   {
       var client = new HttpClient();
       client.DefaultRequestHeaders.Add("Authorization", "Bearer <你的 API KEY>");
       var response = await client.GetStringAsync("https://maas-openapi.wanjiedata.com/api/v1/models");
       Console.WriteLine(response);
   }
}

响应示例 ​

shell
[
    {
        "id": "gpt-5.6-terra-plus",
        "object": "model",
        "created": 1785379812,
        "owned_by": "organization"
    },
    {
        "id": "gpt-5.6-luna-plus",
        "object": "model",
        "created": 1785379812,
        "owned_by": "organization"
    }
]
python
{
  'data': [
    {'id': 'gpt-5.6-sol-plus', 'object': 'model', 'created': 1785379812, 'owned_by': 'organization'},
    {'id': 'hy3', 'object': 'model', 'created': 1785379812, 'owned_by': 'organization'},
    {'id': 'hunyuan-role-latest', 'object': 'model', 'created': 1785379812, 'owned_by': 'organization'}
  ],
  'object': 'list'
}
javascript
模型列表: {
  data: [
    {"id":"gpt-5.6-sol-plus","object":"model","created":1785379812,"owned_by":"organization"},
    {"id":"gpt-5.6-terra-plus","object":"model","created":1785379812,"owned_by":"organization"},
    {"id":"gpt-5.6-luna-plus","object":"model","created":1785379812,"owned_by":"organization"}
  ],
  object: 'list'
}
csharp
{"data":[{"id":"claude-opus-5","object":"model","created":1785379812,"owned_by":"organization"},
{"id":"gpt-5.5-plus","object":"model","created":1785379812,"owned_by":"organization"},
{"id":"gpt-5.6-sol-plus","object":"model","created":1785379812,"owned_by":"organization"},
{"id":"gpt-5.6-terra-plus","object":"model","created":1785379812,"owned_by":"organization"},
{"id":"gpt-5.6-luna-plus","object":"model","created":1785379812,"owned_by":"organization"}],"object":"list"}
  • 获取 Anthropic 端侧模型列表
shell
curl https://maas-openapi.wanjiedata.com/api/anthropic/v1/models \
  -H "Authorization: Bearer $API_KEY"
python
import requests
API_KEY = "<你的 API KEY>"
url = "https://maas-openapi.wanjiedata.com/api/anthropic/v1/models"
headers = {
    "Authorization": f"Bearer {API_KEY}"
}
response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json())
javascript
import axios from 'axios';

const apiKey = '<你的 API KEY>';

async function getModels() {
  try {
    const response = await axios.get('https://maas-openapi.wanjiedata.com/api/anthropic/v1/models', {
      headers: { Authorization: `Bearer ${apiKey}` }
    });
    console.log('模型列表:', response.data);
  } catch (error) {
    console.error('请求失败:', error.response ? error.response.data : error.message);
  }
}

getModels();
csharp
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
   static async Task Main()
   {
       var client = new HttpClient();
       client.DefaultRequestHeaders.Add("Authorization", "Bearer <你的 API KEY>");
       var response = await client.GetStringAsync("https://maas-openapi.wanjiedata.com/api/anthropic/v1/models");
       Console.WriteLine(response);
   }
}

示例如：

shell
{
    "data": [
        {
            "id": "claude-opus-4-6-pro",
            "type": "model",
            "created_at": "2026-07-30 10:50:12",
            "display_name": "claude-opus-4-6-pro"
        },
        {
            "id": "claude-opus-4-7-pro",
            "type": "model",
            "created_at": "2026-07-30 10:50:12",
            "display_name": "claude-opus-4-7-pro"
        },
        {
            "id": "claude-opus-5",
            "type": "model",
            "created_at": "2026-07-30 10:50:12",
            "display_name": "claude-opus-5"
        },
        {
            "id": "claude-opus-5-plus",
            "type": "model",
            "created_at": "2026-07-30 10:50:12",
            "display_name": "claude-opus-5-plus"
        },
        {
            "id": "claude-opus-5-pro",
            "type": "model",
            "created_at": "2026-07-30 10:50:12",
            "display_name": "claude-opus-5-pro"
        }
    ],
    "first_id": "first_id",
    "has_more": "true",
    "last_id": "last_id"
}
python
200
{'data': [{"id":"claude-opus-4-8-pro","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-opus-4-8-pro"},{"id":"claude-sonnet-4-6-pro","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-sonnet-4-6-pro"},{"id":"claude-opus-4-6-pro","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-opus-4-6-pro"},{"id":"claude-opus-4-7-pro","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-opus-4-7-pro"},{"id":"claude-opus-5","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-opus-5"},{"id":"claude-opus-5-plus","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-opus-5-plus"},{"id":"claude-opus-5-pro","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-opus-5-pro"}], 'first_id': 'first_id', 'has_more': 'true', 'last_id': 'last_id'}
javascript
模型列表: {
  data: [
    {
        "id": "claude-opus-4-6-pro",
        "type": "model",
        "created_at": "2026-07-30 10:50:12",
        "display_name": "claude-opus-4-6-pro"
    },
    {
        "id": "claude-opus-4-7-pro",
        "type": "model",
        "created_at": "2026-07-30 10:50:12",
        "display_name": "claude-opus-4-7-pro"
    },
    {
        "id": "claude-opus-5",
        "type": "model",
        "created_at": "2026-07-30 10:50:12",
        "display_name": "claude-opus-5"
    },
    {
        "id": "claude-opus-5-plus",
        "type": "model",
        "created_at": "2026-07-30 10:50:12",
        "display_name": "claude-opus-5-plus"
    },
    {
        "id": "claude-opus-5-pro",
        "type": "model",
        "created_at": "2026-07-30 10:50:12",
        "display_name": "claude-opus-5-pro"
    }
  ],
  first_id: 'first_id',
  has_more: 'true',
  last_id: 'last_id'
}
csharp
{"data":[{"id":"claude-opus-4-8-pro","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-opus-4-8-pro"},{"id":"claude-sonnet-4-6-pro","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-sonnet-4-6-pro"},{"id":"claude-opus-4-6-pro","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-opus-4-6-pro"},{"id":"claude-opus-4-7-pro","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-opus-4-7-pro"},{"id":"claude-opus-5","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-opus-5"},{"id":"claude-opus-5-plus","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-opus-5-plus"},{"id":"claude-opus-5-pro","type":"model","created_at":"2026-07-30 10:50:12","display_name":"claude-opus-5-pro"}],"first_id":"first_id","has_more":"true","last_id":"last_id"}

文本对话接口 ​

shell
POST /v1/chat/completions

注：请求 hunyuan-role-latest、hy3-preview、hy3、hunyuan-vision-1.5-instruct、hunyuan-t1-vision-20250916 模型时，字段 seed 必须为正整数

hunyuan 模型请求示例：

shell
curl --location --request POST 'https://maas-openapi.wanjiedata.com/api/v1/chat/completions' \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "'$hunyuan_MODEL'",
    "messages": [{"role": "user", "content": "请用一句话介绍自己"}],
    "stream": false,
    "seed": 1
}'

非流式请求示例

shell
# 授权模型名称：在模型广场列表中模型名称复制名称获取。
curl --location --request POST 'https://maas-openapi.wanjiedata.com/api/v1/chat/completions' \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "'$MODEL'",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": false
}'
python
import requests
url = "https://maas-openapi.wanjiedata.com/api/v1/chat/completions"
api_key = "<你的 API KEY>"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
data = {
    "model": "<你的授权模型名称>",
    "messages": [
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
}
response = requests.post(url, headers=headers, json=data)
response_json = response.json()
assistant_message = response_json['choices'][0]['message']['content']
print(assistant_message)
javascript
import axios from 'axios';

const apiKey = '<你的 API KEY>';
const model = '<你的授权模型名称>'; 
const url = 'https://maas-openapi.wanjiedata.com/api/v1/chat/completions';

async function testConnection() {
  try {
    const response = await axios.post(url, {
      model,
      messages: [
        { role: 'user', content: 'Hello!' }
      ]
    }, {
      headers: {
        Authorization: `Bearer ${apiKey}`,
        'Content-Type': 'application/json'
      }
    });
    console.log(response.data.choices[0].message.content);
    console.log('API 连接成功');
  } catch (error) {
    console.error('API 连接失败:', error.response?.data || error.message);
  }
}

testConnection();
csharp
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class P {
    static async Task Main() {
        var c = new HttpClient();
        c.DefaultRequestHeaders.Add("Authorization", "Bearer <API_KEY>");
        var d = new StringContent(@"{
            ""model"":""<MODEL>"",
            ""messages"":[{""role"":""user"",""content"":""Hello!""}],
            ""stream"":false
        }", Encoding.UTF8, "application/json");
        var r = await c.PostAsync("https://maas-openapi.wanjiedata.com/api/v1/chat/completions", d);
        System.Console.WriteLine(await r.Content.ReadAsStringAsync());
    }
}

非流式响应示例

shell
{
    "id": "chatcmpl-E7Eng0KjKlCDnEpwIeLm1iKydN6Tu",
    "request_id": "88573fcc-a717-4e69-8528-236f0253b703",
    "object": "chat.completion",
    "created": 1785393896,
    "model": "gpt-5.6-sol-plus",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "我是一个由 OpenAI 训练的 AI 助手，能够帮助你解答问题、整理信息、创作内容并完成多种语言任务。",
                "tool_calls": null
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 12,
        "completion_tokens": 37,
        "total_tokens": 49
    }
}
python
Hello! 😊 How can I assist you today?
javascript
Hello! 😊 How can I assist you today? Whether you have a question, need help with something, or just want to chat, I'm here for you!
API 连接成功
csharp
{
  "id":"chatcmpl-E7Eng0KjKlCDnEpwIeLm1iKydN6Tu",
"request_id": "88573fcc-a717-4e69-8528-236f0253b703",
"object":"chat.completion","created":1785393896,
"model":"gpt-5.6-sol-plus","choices":[{"index":0,"message":{"role":"assistant",
"content":"我是一个由 OpenAI 训练的 AI 助手，能够帮助你解答问题、整理信息、创作内容并完成多种语言任务。",
"tool_calls":null},"finish_reason":"stop"}],
"usage":{"prompt_tokens":12,"completion_tokens":37,"total_tokens":49}
}

流式请求示例

注：qwq-plus 模型只能使用流式请求，即 stream 字段必须设置为 true

shell
# 授权模型名称：在授权模型列表中模型名称复制名称获取。
curl --location --request POST 'https://maas-openapi.wanjiedata.com/api/v1/chat/completions' \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "'$MODEL'",
    "messages": [{"role": "user", "content": "请用一句话介绍自己"}],
    "stream": true
}'
python
import requests

API_KEY = "<你的 API KEY>"
MODEL = "<你的授权模型名称>"

url = 'https://maas-openapi.wanjiedata.com/api/v1/chat/completions'
headers = {
    'Authorization': f"Bearer {API_KEY}"
    'Content-Type': 'application/json'
}
data = {
    "model": MODEL,
    "messages": [{"role": "user", "content": "请用一句话介绍自己"}],
    "stream": True
}

response = requests.post(url, headers=headers, json=data)
print(response.text)
javascript
fetch('https://maas-openapi.wanjiedata.com/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <你的 API KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: '<你的授权模型名称>',
    messages: [{ role: 'user', content: '请用一句话介绍自己' }],
    stream: true
  })
})
.then(res => res.text())
.then(console.log);
csharp
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class P {
    static async Task Main() {
        var c = new HttpClient();
        c.DefaultRequestHeaders.Add("Authorization", "Bearer <API_KEY>");
        var d = new StringContent(@"{
            ""model"":""<MODEL>"",
            ""messages"":[{""role"":""user"",""content"":""请用一句话介绍自己""}],
            ""stream"":true
        }", Encoding.UTF8, "application/json");
        var r = await c.PostAsync("https://maas-openapi.wanjiedata.com/api/v1/chat/completions", d);
        System.Console.WriteLine(await r.Content.ReadAsStringAsync());
    }
}

流式响应示例

shell
{
    "id": "chatcmpl-E7ExPNek7vAmjUupwBmbii1IHkBDM",
    "request_id": "f57bafb8-5593-4a53-ab5f-724a8a02e5d4",
    "object": "chat.completion.chunk",
    "created": 1785394499,
    "model": "gpt-5.6-sol-plus",
    "system_fingerprint": "fp_124299",
    "choices": [],
    "usage": {
        "prompt_tokens": 12,
        "completion_tokens": 35,
        "total_tokens": 47,
        "prompt_tokens_details": {
            "cached_tokens": 0,
            "audio_tokens": 0
        },
        "completion_tokens_details": {
            "reasoning_tokens": 0,
            "audio_tokens": 0,
            "accepted_prediction_tokens": 0,
            "rejected_prediction_tokens": 0
        }
    }
}
[DONE
]
python
id: 0
data: {"id":"chatcmpl-E7ExPNek7vAmjUupwBmbii1IHkBDM","request_id":"f57bafb8-5593-4a53-ab5f-724a8a02e5d4","object":"chat.completion.chunk","created":1785394499,"model":"gpt-5.6-sol-plus","system_fingerprint":"fp_854213","choices":[{"index":0,"delta":{"role":"assistant","content":null,"reasoning_content":"","refusal":null,"tool_calls":null},"logprobs":null,"finish_reason":"stop"}],"usage":null}
id: 1
data: {"id":"chatcmpl-E7ExPNek7vAmjUupwBmbii1IHkBDM","request_id":"f57bafb8-5593-4a53-ab5f-724a8a02e5d4","object":"chat.completion.chunk","created":1785394499,"model":"gpt-5.6-sol-plus","system_fingerprint":"fp_649894","choices":[{"index":0,"delta":{"role":"assistant","content":"。","reasoning_content":"","refusal":null,"tool_calls":null},"logprobs":null,"finish_reason":null}],"usage":null}
...
id: 214
data: [DONE]
javascript
id: 0
data: {"id":"chatcmpl-E7ExPNek7vAmjUupwBmbii1IHkBDM","request_id":"f57bafb8-5593-4a53-ab5f-724a8a02e5d4","object":"chat.completion.chunk","created":1785394499,"model":"gpt-5.6-sol-plus","system_fingerprint":"fp_854213","choices":[{"index":0,"delta":{"role":"assistant","content":null,"reasoning_content":"","refusal":null,"tool_calls":null},"logprobs":null,"finish_reason":"stop"}],"usage":null}
id: 1
data: {"id":"chatcmpl-E7ExPNek7vAmjUupwBmbii1IHkBDM","request_id":"f57bafb8-5593-4a53-ab5f-724a8a02e5d4","object":"chat.completion.chunk","created":1785394499,"model":"gpt-5.6-sol-plus","system_fingerprint":"fp_649894","choices":[{"index":0,"delta":{"role":"assistant","content":"。","reasoning_content":"","refusal":null,"tool_calls":null},"logprobs":null,"finish_reason":null}],"usage":null}
...
id: 214
data: [DONE]
csharp
id: 0
data: {"id":"chatcmpl-E7ExPNek7vAmjUupwBmbii1IHkBDM","request_id":"f57bafb8-5593-4a53-ab5f-724a8a02e5d4","object":"chat.completion.chunk","created":1785394499,"model":"gpt-5.6-sol-plus","system_fingerprint":"fp_854213","choices":[{"index":0,"delta":{"role":"assistant","content":null,"reasoning_content":"","refusal":null,"tool_calls":null},"logprobs":null,"finish_reason":"stop"}],"usage":null}

...

id: 213
data: {"id":"chatcmpl-E7ExPNek7vAmjUupwBmbii1IHkBDM","request_id":"f57bafb8-5593-4a53-ab5f-724a8a02e5d4","object":"chat.completion.chunk","created":1785394499,"model":"gpt-5.6-sol-plus","system_fingerprint":"fp_124299","choices":[],"usage":{"prompt_tokens":12,"completion_tokens":35,"total_tokens":47,"prompt_tokens_details":{"cached_tokens":0,"audio_tokens":0},"completion_tokens_details":{"reasoning_tokens":0,"audio_tokens":0,"accepted_prediction_tokens":0,"rejected_prediction_tokens":0}}}

id: 214
data: [DONE]

文本对话接口参数说明见 OpenAI API Chat completions

  • 支持的模型：GPT Image 2、Nano Banana Pro
shell
POST /v1/images/generations
shell
curl --location --request POST 'https://maas-openapi.wanjiedata.com/api/v1/images/generations' \
--header "Authorization: Bearer $API_KEY"  \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "'$MODEL'",
  "prompt": "graphic of a Harley Davidson bike",
  "n": 1,
  "size": "1024x1024",
  "responseFormat": "url",
  "quality": "standard",
  "style": "vivid"
}'
python
import requests
API_KEY = "<你的 API KEY>"
MODEL = "<你的授权文生图模型名称>"
url = "https://maas-openapi.wanjiedata.com/api/v1/images/generations"
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}
payload = {
    "model": MODEL,
    "prompt": "graphic of a Harley Davidson bike",
    "n": 1,
    "size": "1024x1024",
    "responseFormat": "url",
    "quality": "standard",
    "style": "vivid"
}
response = requests.post(url, headers=headers, json=payload)
if response.status_code == 200:
    result = response.json()
    print(result) 
else:
    print("请求失败:", response.status_code)
    print(response.text)
javascript
import axios from 'axios';

const apiKey = '<你的 API KEY>'; 
const model = '<你的授权文生图模型名称>'; 
const url = 'https://maas-openapi.wanjiedata.com/api/v1/images/generations';

async function generateImage() {
  const headers = {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  };
  const data = {
    model,
    prompt: 'graphic of a Harley Davidson bike',
    n: 1,
    size: '1024x1024',
    responseFormat: 'url'
  };

  try {
    const res = await axios.post(url, data, { headers });
    console.log(res.data.data[0].url); 
  } catch (err) {
    console.error('请求失败:', err.message);
  }
}

generateImage();
csharp
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class P {
    static async Task Main() {
        var c = new HttpClient();
        c.DefaultRequestHeaders.Add("Authorization", "Bearer <API_KEY>");
        var d = new StringContent(@"{
            ""model"":""<MODEL>"",
            ""prompt"":""graphic of a Harley Davidson bike"",
            ""n"":1,
            ""size"":""1024x1024"",
            ""responseFormat"":""url"",
            ""quality"":""standard"",
            ""style"":""vivid""
        }", Encoding.UTF8, "application/json");
        var r = await c.PostAsync("https://maas-openapi.wanjiedata.com/api/v1/images/generations", d);
        System.Console.WriteLine(await r.Content.ReadAsStringAsync());
    }
}

响应示例

shell
{
    "created": 1762221608,
    "data": [
        {
            "url": "https://rgw.wanjiedata.com/maas-public-bucket/2025/11/04/c3fe6bdd3a601f90c4d1e33e961e064f.jpg"
        }
    ],
    "usage": {
        "input_tokens_details": {}
    }
}
python
{
    'created': 1762220795, 
    'data': [{'url': 'https://rgw.wanjiedata.com/maas-public-bucket/2025/11/04/a920b1331c7c5676624e38cbc10d8b43.jpg'}],
    'usage': {'input_tokens_details': {}
    }
    }
javascript
https://rgw.wanjiedata.com/maas-public-bucket/2025/11/04/0d4e5bc27fe7b76a1544a36d75f4c1da.jpg
csharp
{"created":1762414008,"data":[{"url":"https://rgw.wanjiedata.com/maas-public-bucket/2025/11/06/6c6eaaa374eb4be4a629b3adff530412.jpg"}],"usage":{"input_tokens_details":{}}}

版权所有 © 2023-2026 北京万界数据科技有限公司