使用大模型 Token

本文档以 deepseek-v4-flash 模型为例，演示如何快速上手大模型云服务。

1. 平台简介

共绩算力 MaaS（Model-as-a-Service）平台是一个提供多种主流大语言模型 API 服务的统一平台。开发者只需一次接入，即可通过统一的接口规范调用来自 DeepSeek、Minimax、Moonshot (Kimi)、Qwen (通义千问) 和 Zhipu (智谱) 等多家厂商的先进模型。

本文档将以 deepseek-v4-flash 模型为例，为你演示如何快速上手并调用平台提供的 API 服务。

2. 准备工作

在开始调用 API 之前，你需要获取平台的 API 访问密钥（Access Token）。

2.1 平台环境信息

共绩算力平台提供以下关键端点供开发者使用：

3. 了解模型信息

以 deepseek-v4-flash 模型为例，在调用前需要了解其基本参数。该模型由深度求索（DeepSeek）提供，是一款兼具速度与性价比的模型。

3.1 模型标识符

在 API 调用中，使用完整的模型 ID 指定模型：

deepseek/deepseek-v4-flash

3.2 兼容性说明

4. 快速调用指南

以下是使用 Python 和 cURL 调用 deepseek-v4-flash 的示例。平台支持标准的 Chat Completions 接口，并同时支持流式（Streaming）和非流式（Non-streaming）输出。

pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="替换为您自己的 API Key",
    base_url="https://api.suanli.cn/v1",
)

response = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash",
    messages=[
        {"role": "system", "content": "你是一个有用的 AI 助手。"},
        {"role": "user", "content": "请用一句话解释什么是大语言模型。"}
    ],
    max_tokens=1000,
    temperature=0.7
)

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

from openai import OpenAI

client = OpenAI(
    api_key="替换为您自己的 API Key",
    base_url="https://api.suanli.cn/v1",
)

stream = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash",
    messages=[
        {"role": "user", "content": "请简要介绍 Python 语言的三个主要特点。"}
    ],
    max_tokens=1000,
    stream=True
)

print("模型回复：", end="")
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
print()

curl -X POST "https://api.suanli.cn/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 替换为您自己的 API Key" \
-d '{
  "model": "deepseek/deepseek-v4-flash",
  "messages": [
    {
      "role": "user",
      "content": "你好"
    }
  ],
  "max_tokens": 100,
  "temperature": 0.7
}'

5. 进阶功能：获取可用模型列表

平台不仅提供 DeepSeek 模型，还支持众多其他厂商的模型。你可以通过 models.list() 接口获取当前账户可用的所有模型列表：

from openai import OpenAI

client = OpenAI(
    api_key="替换为您自己的 API Key",
    base_url="https://api.suanli.cn/v1",
)

models = client.models.list()
print("当前可用模型列表：")
for m in models.data:
    print(f"  - {m.id}")