docs(api): 同步 /api/v1/chat/completions 的 OpenAPI 与同步响应

补充 Chat Completions 的兼容响应模型与路由注释，确保 /api/v1/chat/completions 按同步兼容格式返回并更新对应测试与 Swagger 文档。
2026-05-16 00:19:39 +08:00
parent 34c3251c6d
commit ae197a742f
7 changed files with 491 additions and 154 deletions
@@ -242,6 +242,32 @@ type CompatibleResponse struct {
 	Usage   map[string]interface{}   `json:"usage,omitempty"`
 }

+type ChatCompletionCompatibleResponse struct {
+	ID      string                 `json:"id" example:"chatcmpl-123"`
+	Object  string                 `json:"object" example:"chat.completion"`
+	Created int64                  `json:"created,omitempty" example:"1710000000"`
+	Model   string                 `json:"model" example:"gpt-4o-mini"`
+	Choices []ChatCompletionChoice `json:"choices"`
+	Usage   *ChatCompletionUsage   `json:"usage,omitempty"`
+}
+
+type ChatCompletionChoice struct {
+	Index        int                         `json:"index" example:"0"`
+	Message      ChatCompletionChoiceMessage `json:"message"`
+	FinishReason string                      `json:"finish_reason,omitempty" example:"stop"`
+}
+
+type ChatCompletionChoiceMessage struct {
+	Role    string `json:"role" example:"assistant"`
+	Content string `json:"content" example:"Hello"`
+}
+
+type ChatCompletionUsage struct {
+	PromptTokens     int `json:"prompt_tokens,omitempty" example:"12"`
+	CompletionTokens int `json:"completion_tokens,omitempty" example:"8"`
+	TotalTokens      int `json:"total_tokens,omitempty" example:"20"`
+}
+
 type NetworkProxyConfigResponse struct {
 	GlobalHTTPProxy       string `json:"globalHttpProxy" example:"http://127.0.0.1:7890"`
 	GlobalHTTPProxySet    bool   `json:"globalHttpProxySet" example:"true"`