Sân chơi API
Tương tácThử mọi model và endpoint ngay trong trình duyệt với key của riêng bạn — đầu ra streaming, trình kiểm tra yêu cầu và mã được tạo sẵn để dán thẳng vào ứng dụng.
Playground là một bảng điều khiển chat cho API tại /docs/playground. Bạn trò chuyện với một model, và playground gửi cùng những yêu cầu mà mã của bạn sẽ gửi: tới một trong ba endpoint, với model, system prompt, tham số và tool bạn đặt. Mọi yêu cầu có thể được xem lại dưới dạng mã và dưới dạng các sự kiện stream thô.
Bắt đầu
- Cung cấp một key — Khi đã đăng nhập, playground dùng API key của tài khoản bạn và hiển thị số dư của bạn. Khi chưa đăng nhập, hãy chọn Add key và dán một key: key chỉ được giữ trong tab này và không bao giờ được lưu.
- Chọn endpoint và model — Thanh trên cùng có công tắc endpoint và bộ chọn model. Một cuộc hội thoại mới bắt đầu trên Chat Completions với
shannon-3. - Gửi một tin nhắn — Gõ bên dưới và nhấn Enter. Mỗi phản hồi được thêm vào cuộc hội thoại, nên tin nhắn tiếp theo tiếp tục nó. Màn hình trống đưa ra ba prompt khởi đầu và một ví dụ gọi tool sẵn có.
Bạn tìm và xoay vòng key của mình ở trang Keys & usage. Keys & usage
Endpoint và model
Công tắc endpoint quyết định playground xây dựng yêu cầu theo định dạng nào. Bạn có thể đổi nó giữa chừng một cuộc hội thoại; các tin nhắn vẫn được giữ.
| Endpoint | Yêu cầu được gửi | Tham chiếu |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | Định dạng Anthropic |
Bộ chọn model liệt kê những gì GET /v1/models trả về. Có thể tìm kiếm trong đó, nó giữ các model gần đây của bạn ở trên cùng, và hiển thị cho mỗi model giá cho mỗi 1M token, cửa sổ ngữ cảnh và các dấu hiệu cho tool, đầu vào hình ảnh, suy luận và đầu ra có cấu trúc.
Cuộc hội thoại
- Phản hồi được stream vào cuộc hội thoại khi chúng được viết. Phần suy luận của model được hiển thị trong một khối riêng mà bạn có thể thu gọn.
- Bên dưới mỗi phản hồi: thời gian đến token đầu tiên, token mỗi giây, thời gian đã trôi qua, token đầu vào và đầu ra cùng các phần được cache và suy luận, ước tính chi phí của lượt, lý do kết thúc và response id.
- Tin nhắn của bạn có thể được chỉnh sửa và gửi lại từ điểm đó. Một phản hồi có thể được tạo lại. Một tin nhắn có thể bị xóa, và việc xóa có thể được hoàn tác trong vài giây.
- Stop hoặc phím Esc kết thúc phản hồi đang được viết.
- Hình ảnh được đính kèm bằng nút hình ảnh, bằng cách dán hoặc thả một tệp, với các model nhận hình ảnh. Hình ảnh được thu nhỏ về 1,568 pixel ở cạnh dài trước khi gửi. Tệp trên 30 MB bị bỏ qua.
- Khung soạn thảo và system prompt hiển thị số token. Với các model open-weight hosted, đó là số đếm chính xác từ
POST /v1/tokenize. Với các model khác, đó là ước tính, được đánh dấu bằng≈. - Yêu cầu thất bại sẽ hiển thị việc cần làm tiếp theo: đặt key khi key bị từ chối, nạp thêm khi số dư đã dùng hết, số giây phải chờ sau khi quá nhiều yêu cầu, hoặc thử lại sau lỗi server.
Cài đặt yêu cầu
Nút Settings mở một bảng với sáu tab. Cài đặt thuộc về cuộc hội thoại: mỗi cuộc hội thoại giữ cài đặt riêng.
| Tab | Nội dung |
|---|---|
| Hệ thống | System prompt của cuộc hội thoại, được gửi cùng mọi yêu cầu. Năm mẫu có thể điền sẵn vào đó, và số token của nó được hiển thị. |
| Tham số | Số token đầu ra tối đa, temperature, top_p, mức độ suy luận, chuỗi dừng, seed, và các công tắc cho streaming và tìm kiếm web. Điều khiển mà endpoint được chọn không có trường tương ứng sẽ bị tắt và được đánh dấu. |
| Công cụ | Các định nghĩa tool được gửi cùng yêu cầu: bốn mẫu có sẵn (get_weather, read_file, run_shell, web_search) hoặc định nghĩa riêng của bạn dưới dạng JSON, và tool_choice (auto, none, required hoặc một tool theo tên). Khi model gọi một tool, cuộc hội thoại hiển thị lần gọi cùng một ô cho kết quả. Khi Offer sample results bật, một cú nhấp sẽ điền một kết quả mẫu. Bạn cũng có thể tự nhập, rồi gửi để tiếp tục lượt. |
| Cấu trúc | response_format: text, json_object hoặc json_schema với tên schema và một JSON schema. Khi đã đặt schema, câu trả lời cuối được kiểm tra theo nó và được đánh dấu trong cuộc hội thoại là khớp hay không. Tab này bị tắt trên endpoint Messages, và tùy chọn mà model được chọn không nhận sẽ không được đưa ra. |
| Mã | Yêu cầu của cuộc hội thoại hiện tại dưới dạng mã cURL, Python, Node hoặc Go, được dựng từ cuộc hội thoại và cài đặt của nó. Key được in là YOUR_API_KEY. Mã có thể được sao chép hoặc mở trong chế độ xem lớn. |
| Sự kiện | Lượt cuối đúng như khi đi qua đường truyền: mọi sự kiện stream với độ lệch thời gian và một bộ lọc, phản hồi đã ghép, các header phản hồi (x-request-id, content-type, retry-after, date) và nội dung yêu cầu. Chúng được giữ cho đến khi trang được tải lại. |
Kiểm tra đầu vào
Các giá trị bạn nhập được kiểm tra trước khi gửi yêu cầu. Giá trị nằm ngoài phạm vi được đánh dấu ngay tại trường của nó, và việc gửi bị giữ lại cho đến khi được sửa.
| Cài đặt | Kiểm tra |
|---|---|
| Số token đầu ra tối đa | Một số nguyên từ 1 đến max_output_tokens của model. |
| Temperature | Một số từ 0 đến 2. Để trống thì trường bị bỏ khỏi yêu cầu. |
top_p | Một số từ 0 đến 1. Để trống thì trường bị bỏ khỏi yêu cầu. |
seed | Một số nguyên. |
| Chuỗi dừng | Tối đa 4, phân tách bằng dấu phẩy. |
response_format | Phải là loại mà model được chọn nhận. Cuộc hội thoại được chuyển sang model không có json_schema hoặc không có response_format sẽ bị giữ lại kèm lý do. |
| Hình ảnh | Bị xóa khỏi tin nhắn khi bạn chuyển sang model chỉ nhận văn bản, kèm một ghi chú. |
So sánh hai model
Compare two models trong menu More thêm một bộ chọn model thứ hai. Khi đó mỗi tin nhắn được gửi tới cả hai model cùng lúc, với cùng cài đặt, và hai câu trả lời nằm cạnh nhau, đánh dấu A và B. Bạn có thể tạo lại riêng một bên. Khi một bên gọi tool, kết quả bạn gửi chỉ tiếp tục bên đó.
Chia sẻ, xuất và nhập
- Copy share link đóng gói cuộc hội thoại vào chính liên kết, trong phần sau dấu
#. Không có gì được tải lên. Hình ảnh, key của bạn và chi tiết của lần chạy cuối bị loại ra. Ai mở liên kết sẽ nhận cuộc hội thoại như một cuộc hội thoại mới trong playground của họ. - Cuộc hội thoại quá dài cho một liên kết sẽ bị từ chối kèm ghi chú. Hãy tải xuống dưới dạng JSON thay thế.
- Download conversation JSON lưu cuộc hội thoại cùng cài đặt của nó thành một tệp. Import JSON trong bảng cuộc hội thoại mở một tệp như vậy.
- Copy as cURL sao chép yêu cầu hiện tại thành một lệnh cURL.
Cái gì được lưu ở đâu
| Nội dung | Nơi lưu giữ |
|---|---|
| Cuộc hội thoại, tool đã lưu, model gần đây, bố cục bảng | Trong trình duyệt này. Chúng không được gửi tới Shannon và không đi theo bạn sang thiết bị khác. |
| API key | Trong bộ nhớ của tab đang mở. Key đã dán sẽ mất khi trang được tải lại hoặc tab đóng. Khi đã đăng nhập, key được đọc từ tài khoản của bạn mỗi lần. |
| Sự kiện stream, header và yêu cầu của lượt cuối | Trong trang đang mở, cho đến khi nó được tải lại. |
| Yêu cầu | Được gửi từ trình duyệt của bạn tới API bằng key của bạn. Chúng được tính vào số dư của bạn như mọi yêu cầu API khác. |
Bàn phím
| Phím | Tác dụng |
|---|---|
Enter | Gửi tin nhắn. |
Shift + Enter | Xuống dòng mới. |
Ctrl + K | Mở bảng lệnh: đổi endpoint hoặc model, đặt một mẫu system, bắt đầu cuộc hội thoại mới, bật/tắt streaming, tool hoặc so sánh. Trên Mac: ⌘ K. |
Esc | Dừng phản hồi đang được viết, hoặc đóng một bảng đang mở trên màn hình hẹp. |