API 플레이그라운드

인터랙티브

자신의 키로 브라우저에서 모든 모델과 엔드포인트를 사용해 보세요. 스트리밍 출력, 요청 인스펙터, 앱에 바로 붙여넣을 수 있는 생성 코드를 제공합니다.

플레이그라운드는 /docs/playground에 있는 API용 채팅 콘솔입니다. 모델과 대화하면 플레이그라운드가 코드가 보내는 것과 같은 요청을 세 엔드포인트 중 하나로, 사용자가 설정한 모델, 시스템 프롬프트, 파라미터, 도구와 함께 보냅니다. 모든 요청은 코드와 원시 스트림 이벤트로 다시 확인할 수 있습니다.

시작하기

키 입력 — 로그인하면 플레이그라운드가 계정의 API 키를 사용하고 잔액을 표시합니다. 로그인하지 않았다면 Add key를 선택하고 키를 붙여넣으세요. 키는 이 탭에만 유지되며 저장되지 않습니다.
엔드포인트와 모델 선택 — 상단 바에 엔드포인트 스위치와 모델 선택기가 있습니다. 새 대화는 Chat Completions와 shannon-3으로 시작합니다.
메시지 보내기 — 아래에 입력하고 Enter를 누르세요. 모든 응답은 대화에 추가되므로 다음 메시지가 이어집니다. 빈 화면에는 시작용 프롬프트 세 개와 바로 쓸 수 있는 도구 호출 예시가 있습니다.

키는 Keys & usage 페이지에서 확인하고 교체할 수 있습니다. Keys & usage

엔드포인트와 모델

엔드포인트 스위치는 플레이그라운드가 만드는 요청 형식을 결정합니다. 대화 도중에 바꿀 수 있으며 메시지는 그대로 유지됩니다.

엔드포인트	보내는 요청	참조
Chat Completions	`POST /v1/chat/completions`	Chat Completions
Responses	`POST /v1/responses`	Responses API
Messages	`POST /v1/messages`	Anthropic 형식

모델 선택기는 GET /v1/models가 반환하는 모델을 나열합니다. 검색할 수 있고, 최근 사용한 모델을 맨 위에 유지하며, 모델마다 1M tokens당 가격, 컨텍스트 윈도우, 그리고 도구, 이미지 입력, 추론, 구조화된 출력 표시를 보여 줍니다.

대화

응답은 작성되는 대로 스레드에 스트리밍됩니다. 모델의 추론은 접을 수 있는 별도의 블록에 표시됩니다.
각 응답 아래에는 첫 토큰까지의 시간, 초당 토큰 수, 경과 시간, 캐시된 부분과 추론 부분을 포함한 입력 및 출력 토큰, 해당 턴의 추정 비용, 종료 사유, 응답 id가 표시됩니다.
내가 보낸 메시지는 수정한 뒤 그 지점부터 다시 보낼 수 있습니다. 응답은 다시 생성할 수 있습니다. 메시지는 삭제할 수 있고, 삭제는 몇 초 동안 실행 취소할 수 있습니다.
Stop 또는 Esc 키로 작성 중인 응답을 끝낼 수 있습니다.
이미지를 받는 모델에서는 이미지 버튼, 붙여넣기, 파일 끌어놓기로 이미지를 첨부합니다. 이미지는 전송 전에 긴 변이 1,568픽셀이 되도록 축소됩니다. 30 MB를 넘는 파일은 건너뜁니다.
입력창과 시스템 프롬프트에는 토큰 수가 표시됩니다. 호스팅 오픈 웨이트 모델의 경우 POST /v1/tokenize의 정확한 값입니다. 다른 모델은 추정치이며 ≈로 표시됩니다.
실패한 요청에는 다음에 할 일이 표시됩니다: 키가 거부되면 키 설정, 잔액을 다 쓰면 충전, 요청이 너무 많으면 기다릴 초 수, 서버 오류 뒤에는 재시도.

요청 설정

Settings 버튼은 여섯 개의 탭이 있는 패널을 엽니다. 설정은 대화에 속하며 대화마다 자체 설정을 유지합니다.

탭	내용
시스템	대화의 시스템 프롬프트이며 모든 요청과 함께 전송됩니다. 템플릿 다섯 개로 채울 수 있고 토큰 수가 표시됩니다.
파라미터	최대 출력 tokens, 온도, `top_p`, 추론 강도, 중단 시퀀스, `seed`, 그리고 스트리밍과 웹 검색 스위치입니다. 선택한 엔드포인트에 해당 필드가 없는 컨트롤은 꺼지고 표시됩니다.
도구	요청과 함께 보내는 도구 정의입니다: 프리셋 네 개(`get_weather`, `read_file`, `run_shell`, `web_search`) 또는 JSON으로 직접 작성한 정의, 그리고 `tool_choice`(`auto`, `none`, `required`, 또는 이름으로 지정한 도구 하나). 모델이 도구를 호출하면 스레드에 결과 입력란이 있는 호출이 표시됩니다. Offer sample results를 켜면 한 번의 클릭으로 샘플 결과가 채워집니다. 직접 입력한 뒤 전송하여 턴을 이어갈 수도 있습니다.
구조화	`response_format`: `text`, `json_object`, 또는 스키마 이름과 JSON 스키마가 있는 `json_schema`. 스키마를 설정하면 마지막 답변이 스키마와 대조되어 일치 여부가 스레드에 표시됩니다. 이 탭은 Messages 엔드포인트에서는 꺼져 있으며, 선택한 모델이 받지 않는 옵션은 제공되지 않습니다.
코드	현재 대화의 요청을 대화와 설정을 바탕으로 만든 cURL, Python, Node, Go 코드로 보여 줍니다. 키는 `YOUR_API_KEY`로 표시됩니다. 코드를 복사하거나 큰 화면으로 열 수 있습니다.
이벤트	마지막 턴이 네트워크로 오간 그대로를 보여 줍니다: 시간 오프셋이 있는 모든 스트림 이벤트와 필터, 조합된 응답, 응답 헤더(`x-request-id`, `content-type`, `retry-after`, `date`), 요청 본문. 페이지를 새로고침할 때까지 유지됩니다.

입력 검사

입력한 값은 요청을 보내기 전에 검사됩니다. 범위를 벗어난 값은 해당 필드에 표시되며, 수정할 때까지 전송이 보류됩니다.

설정	검사
최대 출력 tokens	1부터 모델의 `max_output_tokens`까지의 정수입니다.
온도	0에서 2 사이의 숫자입니다. 비워 두면 요청에서 이 필드를 생략합니다.
`top_p`	0에서 1 사이의 숫자입니다. 비워 두면 요청에서 이 필드를 생략합니다.
`seed`	정수입니다.
중단 시퀀스	쉼표로 구분하여 최대 4개입니다.
`response_format`	선택한 모델이 받는 값이어야 합니다. `json_schema` 또는 `response_format`을 지원하지 않는 모델로 옮긴 대화는 이유와 함께 전송이 보류됩니다.
이미지	텍스트만 받는 모델로 전환하면 메시지에서 제거되며 안내가 표시됩니다.

두 모델 비교

More 메뉴의 Compare two models는 두 번째 모델 선택기를 추가합니다. 이후 각 메시지는 같은 설정으로 두 모델에 동시에 전송되고, 두 답변이 A와 B로 표시되어 나란히 놓입니다. 한쪽만 다시 생성할 수 있습니다. 한쪽이 도구를 호출하면 사용자가 보낸 결과는 그쪽에만 이어집니다.

Copy share link는 대화를 링크 자체의 # 뒤 부분에 담습니다. 아무것도 업로드되지 않습니다. 이미지, 키, 마지막 실행의 세부 정보는 포함되지 않습니다. 링크를 연 사람은 자신의 플레이그라운드에서 새 대화로 받게 됩니다.
링크에 담기에 너무 긴 대화는 안내와 함께 거부됩니다. 대신 JSON으로 다운로드하세요.
Download conversation JSON은 대화를 설정과 함께 파일로 저장합니다. 대화 패널의 Import JSON은 그런 파일을 엽니다.
Copy as cURL은 현재 요청을 cURL 명령 하나로 복사합니다.

무엇이 어디에 보관되는가

항목	보관 위치
대화, 저장된 도구, 최근 모델, 패널 레이아웃	이 브라우저에 있습니다. Shannon으로 전송되지 않으며 다른 기기로 따라가지 않습니다.
API 키	열려 있는 탭의 메모리에 있습니다. 붙여넣은 키는 페이지를 새로고침하거나 탭을 닫으면 사라집니다. 로그인한 경우 키는 매번 계정에서 읽어 옵니다.
마지막 턴의 스트림 이벤트, 헤더, 요청	열려 있는 페이지에 있으며 새로고침할 때까지 유지됩니다.
요청	브라우저에서 키와 함께 API로 전송됩니다. 다른 API 요청과 마찬가지로 잔액에서 차감됩니다.

키보드

키	기능
`Enter`	메시지를 전송합니다.
`Shift` + `Enter`	새 줄을 시작합니다.
`Ctrl` + `K`	커맨드 팔레트를 엽니다: 엔드포인트 또는 모델 전환, 시스템 템플릿 설정, 새 대화 시작, 스트리밍, 도구, 비교 토글. Mac에서는 ⌘ K.
`Esc`	작성 중인 응답을 중단하거나, 좁은 화면에서 열려 있는 패널을 닫습니다.

플레이그라운드 실행