Skip to content

Tạo đầu ra có cấu trúc

POST
/v1/chat/completions
  • Dùng response_format để chỉ định JSON Schema ràng buộc cấu trúc đầu ra của mô hình
  • Hỗ trợ chế độ json_schema với strict: true để tuân thủ schema nghiêm ngặt
  • Phản hồi không luồng; nhận phần hoàn thành tuân thủ schema trong một lần
  • Tài liệu chính thức: Structured Outputs

Authorizations

bearer
Type
HTTP (bearer)

Request Body

application/json
object

Mô hình sử dụng. Xem bảng tương thích endpoint mô hình với Chat API.

object[]
Required

Danh sách tin nhắn trong cuộc hội thoại cho đến nay.

Nhiệt độ lấy mẫu từ 0 đến 2. Giá trị cao hơn (vd. 0,8) làm đầu ra ngẫu nhiên hơn; thấp hơn (vd. 0,2) tập trung hơn. Thường chỉ nên thay đổi tham số này hoặc top_p, không cả hai.

Nucleus sampling alternative to temperature. The model considers tokens with top_p probability mass (e.g. 0.1 = top 10%). We generally recommend changing this or temperature, but not both.

Mặc định 1. Số lựa chọn hoàn thành chat tạo cho mỗi tin nhắn đầu vào.

Default false. For structured outputs, omit or set false to receive the full schema-compliant completion in one response.

Mặc định null. Tối đa 4 chuỗi khiến API dừng sinh token.

Default inf. Maximum tokens to generate in the completion.

Total length of input + output tokens is limited by the model context length.

Số từ -2,0 đến 2,0. Giá trị dương phạt token mới theo việc đã xuất hiện trong văn bản, tăng chủ đề mới. Chi tiết

Mặc định 0. Từ -2,0 đến 2,0. Giá trị dương phạt theo tần suất trong văn bản, giảm lặp lại.

Modify the likelihood of specified tokens appearing in the completion.
Accepts a JSON object mapping token IDs to bias values from -100 to 100. Applied to logits before sampling; effect varies by model.

Định danh duy nhất người dùng cuối. Giúp OpenAI giám sát lạm dụng. Tìm hiểu thêm

Đối tượng chỉ định định dạng đầu ra. { "type": "json_object" } bật chế độ JSON. Khi dùng JSON mode, cần hướng dẫn mô hình tạo JSON qua tin nhắn system/user. Với json_schema, cung cấp schema và strict: true tùy chọn cho Structured Outputs.

Beta. Nếu đặt, hệ thống cố lấy mẫu xác định; theo dõi thay đổi qua system_fingerprint trong phản hồi.

Danh sách công cụ mô hình có thể gọi. Hiện chỉ hỗ trợ hàm làm công cụ.

Điều khiển hàm được gọi: none = không gọi; auto = mô hình chọn; ép bằng {"type": "function", "function": {"name": "my_function"}}. Mặc định none nếu không có hàm, ngược lại auto.

Responses

application/json
object
object[]
Required
object
Required

Playground

Authorization
Body

Samples