api接口的使用

## 1 completions接口

在siliconflow，completions接口的api地址为：https://api.siliconflow.cn/v1/completions

### 参数值：

model：需要调用的模型的名称。

> 在siliconflow中，模型的名称一般为【系列名称/具体模型名称】，如“Qwen/Qwen2.5-7B-Instruct”。
>
> 可以在siliconflow中查看并复制。

prompt：输入的提示词。

示例如下：

```json
{
    "model": "Qwen/Qwen2.5-7B-Instruct",
    "prompt": "请生成一首关于秋天的诗。"
}
```

很多大模型的文档中已经不再提供此接口的说明，只提供chat-completions的接口说明。

## 2 chat-completions接口

在siliconflow，chat-completions接口的api地址为：https://api.siliconflow.cn/v1/chat/completions

### 参数值：

model：需要调用的模型的名称，和completions接口想通。

messages：消息列表。

> 这是一个结构体的列表，每个元素类似如下：`{"role": "user", "content": "你好"}` role 可以是 **system**,**user**,**assistant** 。
>
> 其中， **"role": "system"**可以设置系统的角色，**"role": "user"**可以设置用户的提示词，**"role": "assistant"**可以附带历史对话记录。

示例如下：

```json
{
    "model": "Qwen/Qwen2.5-7B-Instruct",
    "messages": [
        {
            "role": "system",
            "content": "你是一个诗人"
        },
        {
            "role": "user",
            "content": "请生成一首关于秋天的诗"
        }
    ]
}
```

在这里，我们设定系统的角色为一个诗人，给它的提示词是让它生成一首关于秋天的诗。

返回结果如下：

```json
{
    "id": "01959eac56b528e644c3271eea826155",
    "object": "chat.completion",
    "created": 1742123849,
    "model": "Qwen/Qwen2.5-7B-Instruct",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "秋风轻唱叶飘零，黄昏漫卷暮云青。\n\n举目遥看西窗景，红叶霜天清月明。"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 23,
        "completion_tokens": 31,
        "total_tokens": 54
    },
    "system_fingerprint": ""
}
```

可以看到，返回结果中的【message】内容如下：

```json
"message": 
{
    "role": "assistant",
    "content": "秋风轻唱叶飘零，黄昏漫卷暮云青。\n\n举目遥看西窗景，红叶霜天清月明。"
},
```

它的角色为**assistant**。

api接口的使用