> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 聊天补全

> 使用 C# SDK 调用 /chat/completions。

**方法**：`client.GenerateText(...)` 或 `client.CreateChatCompletion(...)`

### 示例

```csharp theme={null}
using PhaseoSdk;

var client = new Phaseo(apiKey);
var response = await client.GenerateText(new Dictionary<string, object>
{
    ["model"] = "openai/gpt-5-nano",
    ["messages"] = new[]
    {
        new Dictionary<string, object>
        {
            ["role"] = "user",
            ["content"] = "Write a limerick about lighthouses."
        }
    }
});
```

### 关键参数

* `model`（必填）：目标模型 ID。
* `messages`（必填）：按顺序排列的消息，角色为 `system|user|assistant|tool`；内容可以是文本或分段。
* 采样：`temperature`（0–2）、`top_p`（0–1）、`top_k`（>=1）、`seed`（可选整数）。
* 长度与惩罚：`max_output_tokens`（整数）、`presence_penalty` 和 `frequency_penalty`（-2 到 2）、`stop`（string|string\[]）。
* 工具：`tools`（定义）、`tool_choice`（auto/none/指定工具）、`max_tool_calls`（整数）、`parallel_tool_calls`（布尔值）。
* 对数概率：`logprobs`（布尔值）、`top_logprobs`（0–20）。
* 输出：`response_format`（json/text）、`meta`（透传对象）、`stream`（布尔值）、`service_tier`。
* Gateway 扩展项：`usage`（布尔值，用于请求用量）、`meta`（布尔值，用于包含 meta 块）。

### 返回值

`ChatCompletionsResponse`

```json theme={null}
{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "gpt-3.5-turbo-0125",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello there, how may I assist you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 12,
    "total_tokens": 21
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.