首次调用 API

​

调用前准备

• 已有算秩账号，并且能够登录控制台。
• 在 模型广场 中选择模型，确认模型 ID、支持的能力和价格。示例使用 Qwen/Qwen3.6-27B，如需更换，请使用模型详情页中的模型 ID。
• 准备调用环境：Python 示例使用 OpenAI Python SDK，安装该 SDK 需要 Python 3.10 或更高版本；REST 示例需要 curl。

​

1. 创建并配置 API 密钥

1. 登录控制台，进入 API 密钥 页面，单击 创建 API 密钥。
2. 为密钥设置一个便于识别的名称，并复制生成的 API Key。
3. 在用于运行示例的终端中执行以下命令，将 YOUR_API_KEY 替换为实际密钥。后续调用请在同一个终端中运行。
   export API_KEY="YOUR_API_KEY"
   
   上述命令仅在当前终端会话中生效，重新打开终端后需要再次执行。如需在每次打开终端时自动加载，可以将该命令添加到所用 Shell 的用户启动配置文件中。配置文件会保存明文密钥，请勿共享或提交到代码仓库。

​

2. 调用模型

• Python SDK：在 Python 程序中调用模型，并直接打印回答。
• REST（curl）：不安装 SDK，直接在终端中验证接口请求。

python3 -m pip install --upgrade openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["API_KEY"],
    base_url="https://api.siflow.cn/model-api",
)

response = client.chat.completions.create(
    model="Qwen/Qwen3.6-27B",
    messages=[
        {
            "role": "user",
            "content": "What new opportunities might reasoning models bring to the market?",
        }
    ],
    max_completion_tokens=1024,
    stream=False,
)

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

python3 first_api_call.py

curl https://api.siflow.cn/model-api/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen/Qwen3.6-27B",
    "stream": false,
    "max_completion_tokens": 1024,
    "messages": [
      {"role": "user", "content": "What new opportunities might reasoning models bring to the market?"}
    ]
  }'

​

3. 查看用量与费用

​

调用失败时排查

​

继续使用模型能力

• 构建多轮对话或生成文本：参见 文本生成。
• 提取字段并返回指定结构：参见 结构化输出。
• 让模型调用业务工具：参见 函数调用。
• 处理图像等多模态输入：参见 视觉与多模态。