> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # Claude - Messages API > - 텍스트 및/또는 이미지 콘텐츠가 포함된 구조화된 입력 메시지 목록을 전송하면, 모델이 대화의 다음 메시지를 생성합니다. - Messages API는 단일 쿼리 또는 상태 비저장 다중 턴 대화에 사용할 수 있습니다. **BaseURL**: 기본 BaseURL은 `https://direct.evolink.ai`이며, 텍스트 모델 지원이 더 우수하고 장시간 연결을 지원합니다. `https://api.evolink.ai`는 멀티모달 서비스의 주력 엔드포인트이며, 텍스트 모델에 대해서는 대체 주소로 사용됩니다. ## OpenAPI ````yaml ko/api-manual/language-series/claude/claude-messages-api.json POST /v1/messages openapi: 3.1.0 info: title: Claude Messages API description: >- 텍스트 및/또는 이미지 콘텐츠가 포함된 구조화된 입력 메시지 목록을 전송하면 모델이 대화의 다음 메시지를 생성합니다. Messages API는 단일 쿼리 또는 상태 비저장 다중 턴 대화에 사용할 수 있습니다. license: name: MIT version: 1.0.0 servers: - url: https://direct.evolink.ai description: 프로덕션 (권장) - url: https://api.evolink.ai description: 대체 URL security: - bearerAuth: [] tags: - name: |- 메시지 역할 - `user`: 사용자 메시지 - `assistant`: AI 어시스턴트 메시지 (다중 턴 대화용) - `system`: 시스템 프롬프트 (AI 역할과 동작을 설정) description: Claude AI 메시지 생성 및 대화 API paths: /v1/messages: post: tags: - |- 메시지 역할 - `user`: 사용자 메시지 - `assistant`: AI 어시스턴트 메시지 (다중 턴 대화용) - `system`: 시스템 프롬프트 (AI 역할과 동작을 설정) summary: 메시지 생성 description: |- - 텍스트 및/또는 이미지 콘텐츠가 포함된 구조화된 입력 메시지 목록을 전송하면, 모델이 대화의 다음 메시지를 생성합니다. - Messages API는 단일 쿼리 또는 상태 비저장 다중 턴 대화에 사용할 수 있습니다. operationId: createMessage requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateMessageParams' example: model: claude-opus-4-8 max_tokens: 1024 messages: - role: user content: Hello, world responses: '200': description: |- 메시지 내용. 두 가지 형식을 지원합니다: **1. 일반 텍스트 문자열**: 문자열을 직접 전달합니다, 예: `"content":"자기소개를 해주세요"` **2. 객체 배열** (텍스트 입력, 멀티모달 입력 지원): 아래 구조를 참조하세요 content: application/json: schema: $ref: '#/components/schemas/Message' example: model: claude-haiku-4-5-20251001 id: msg_bdrk_017XLrAa77zWvfBGQ6ESvrxz type: message role: assistant content: - type: text text: |- # Hey there! 👋 How's it going? What can I help you with today? stop_reason: end_turn stop_sequence: null usage: input_tokens: 8 cache_creation_input_tokens: 0 cache_read_input_tokens: 0 output_tokens: 24 '400': description: 잘못된 요청 content: application/json: schema: $ref: 36226cfd-c495-4b70-b301-6d0dca653b99 example: error: message: 잘못된 요청 type: invalid_request_error request_id: type: error '401': description: 인증 오류 content: application/json: schema: $ref: 36226cfd-c495-4b70-b301-6d0dca653b99 example: error: message: 인증 오류 type: authentication_error request_id: type: error '402': description: 과금 오류 content: application/json: schema: $ref: 36226cfd-c495-4b70-b301-6d0dca653b99 example: error: message: 과금 오류 type: billing_error request_id: type: error fallback_suggestion: https://evolink.ai/dashboard/billing '403': description: 권한 오류 content: application/json: schema: $ref: 36226cfd-c495-4b70-b301-6d0dca653b99 example: error: message: Permission denied type: permission_error request_id: type: error '404': description: 찾을 수 없음 content: application/json: schema: $ref: 36226cfd-c495-4b70-b301-6d0dca653b99 example: error: message: 찾을 수 없음 type: not_found_error request_id: type: error '429': description: |- 재현 가능한 결과를 위한 랜덤 시드 **참고:** - 범위: `1`~`2147483647` - 랜덤 시드를 위해 비워두세요 - 동일한 시드와 동일한 프롬프트는 유사한 결과를 생성합니다 content: application/json: schema: $ref: 36226cfd-c495-4b70-b301-6d0dca653b99 example: error: message: Rate limited type: rate_limit_error request_id: type: error fallback_suggestion: retry after 60 seconds '500': description: 내부 서버 오류 content: application/json: schema: $ref: 36226cfd-c495-4b70-b301-6d0dca653b99 example: error: message: 내부 서버 오류 type: api_error request_id: type: error fallback_suggestion: try again later '503': description: 서비스 과부하 content: application/json: schema: $ref: 36226cfd-c495-4b70-b301-6d0dca653b99 example: error: message: Overloaded type: overloaded_error request_id: type: error fallback_suggestion: retry after 30 seconds '524': description: Cloudflare 게이트웨이 타임아웃 오류 content: application/json: schema: $ref: 36226cfd-c495-4b70-b301-6d0dca653b99 example: error: message: Request timeout type: timeout_error request_id: type: error fallback_suggestion: >- BaseURL을 https://direct.evolink.ai로 변경하세요. 이 엔드포인트는 장시간 작업에 더 적합합니다 components: schemas: CreateMessageParams: type: object required: - model - messages - max_tokens additionalProperties: false properties: model: type: string description: 프롬프트를 완성할 모델. enum: - claude-haiku-4-5-20251001 - claude-sonnet-4-5-20250929 - claude-opus-4-5-20251101 - claude-opus-4-6 - claude-fable-5 - claude-opus-4-8 - claude-opus-4-7 - claude-sonnet-4-6 - claude-sonnet-5 examples: - claude-opus-4-8 title: 트리거 시 제거해야 할 최소 토큰 수. 최소한 이만큼의 토큰을 제거할 수 있는 경우에만 컨텍스트가 수정됩니다. messages: type: array description: >- 입력 메시지. 모델은 `user`와 `assistant`가 번갈아 나오는 대화 턴에서 작동하도록 훈련되었습니다. 새 `Message`를 생성할 때 `messages` 매개변수로 이전 대화 턴을 지정하면, 모델이 대화의 다음 `Message`를 생성합니다. 요청에서 연속된 `user` 또는 `assistant` 턴은 하나의 턴으로 결합됩니다. 각 입력 메시지는 `role`과 `content`가 포함된 객체여야 합니다. 단일 `user` 역할 메시지를 지정하거나 여러 `user` 및 `assistant` 메시지를 포함할 수 있습니다. items: $ref: '#/components/schemas/InputMessage' title: |- 메시지 역할 - `user`: 사용자 메시지 - `assistant`: AI 어시스턴트 메시지 (다중 턴 대화용) - `system`: 시스템 프롬프트 (AI 역할과 동작을 설정) max_tokens: type: integer description: |- 중지하기 전에 생성할 최대 토큰 수. 모델이 이 최대값에 도달하기 _전에_ 중지할 수 있습니다. 이 매개변수는 생성할 토큰의 절대 최대 수만 지정합니다. examples: - 1024 minimum: 1 title: 최대 토큰 inference_geo: type: string description: >- 추론 처리를 수행할 지리적 리전을 지정합니다. 지정하지 않으면 워크스페이스의 `default_inference_geo`가 사용됩니다. title: Inference Geo container: description: 요청 간 재사용을 위한 컨테이너 식별자. title: Container anyOf: - $ref: '#/components/schemas/ContainerParams' - type: string - type: 'null' context_management: description: 컨텍스트 관리 설정. anyOf: - $ref: '#/components/schemas/ContextManagementConfig' - type: 'null' mcp_servers: type: array description: 이 요청에 사용될 MCP 서버 items: $ref: '#/components/schemas/RequestMCPServerURLDefinition' maxItems: 20 title: |- 응답에서 생성할 최대 토큰 수 **참고**: - 값이 너무 작으면 응답이 잘릴 수 있습니다 - 최대 토큰에 도달하면 finish_reason이 "length"가 되고, 그렇지 않으면 "stop"이 됩니다 metadata: $ref: '#/components/schemas/Metadata' description: 요청에 대한 메타데이터를 설명하는 객체입니다. output_config: $ref: '#/components/schemas/OutputConfig' description: 모델 출력 설정(출력 형식 등). service_tier: type: string description: 이 요청에 우선 용량 (사용 가능한 경우) 또는 표준 용량을 사용할지 결정합니다. enum: - auto - standard_only title: 서비스 티어 stop_sequences: type: array description: 모델이 생성을 중단하게 하는 사용자 정의 텍스트 시퀀스. items: type: string title: 중지 시퀀스 stream: type: boolean description: 서버 전송 이벤트를 사용하여 응답을 점진적으로 스트리밍할지 여부. title: 스트림 system: description: 시스템 프롬프트. examples: - Today's date is 2024-06-01. title: 시스템 anyOf: - type: string - type: array items: $ref: '#/components/schemas/RequestTextBlock' temperature: type: number description: |- 응답에 주입되는 무작위성의 양입니다. 기본값은 `1.0`입니다. 범위는 `0.0`에서 `1.0`까지입니다. examples: - 1 minimum: 0 maximum: 1 title: Temperature thinking: description: >- Claude의 확장 사고를 활성화하기 위한 설정. `type: "enabled"`에서는 `budget_tokens`가 필요하며, 최소 1,024여야 하고 `max_tokens` 한도에 포함됩니다. `display`로 사고 내용의 표시 방식을 제어할 수 있습니다. `type: "adaptive"`에서는 요청 복잡도에 따라 Claude가 언제, 얼마나 확장 사고를 사용할지 동적으로 결정합니다. 이 경우에도 `display`로 사고 내용의 표시 방식을 제어할 수 있습니다. `type: "disabled"`에서는 확장 사고를 사용하지 않습니다. anyOf: - $ref: '#/components/schemas/ThinkingConfigEnabled' - $ref: '#/components/schemas/ThinkingConfigAdaptive' - $ref: '#/components/schemas/ThinkingConfigDisabled' tool_choice: description: 모델이 제공된 도구를 사용하는 방식. anyOf: - $ref: '#/components/schemas/ToolChoiceAuto' - $ref: '#/components/schemas/ToolChoiceAny' - $ref: '#/components/schemas/ToolChoiceTool' - $ref: '#/components/schemas/ToolChoiceNone' tools: type: array description: 모델이 사용할 수 있는 도구의 정의. items: anyOf: - $ref: '#/components/schemas/Tool' - $ref: '#/components/schemas/BashTool_20241022' - $ref: '#/components/schemas/BashTool_20250124' - $ref: '#/components/schemas/CodeExecutionTool_20250522' - $ref: '#/components/schemas/CodeExecutionTool_20250825' - $ref: '#/components/schemas/ComputerUseTool_20241022' - $ref: '#/components/schemas/MemoryTool_20250818' - $ref: '#/components/schemas/ComputerUseTool_20250124' - $ref: '#/components/schemas/TextEditor_20241022' - $ref: '#/components/schemas/TextEditor_20250124' - $ref: '#/components/schemas/TextEditor_20250429' - $ref: '#/components/schemas/TextEditor_20250728' - $ref: '#/components/schemas/WebSearchTool_20250305' - $ref: '#/components/schemas/WebFetchTool_20250910' title: 도구 top_k: type: integer description: 각 후속 토큰에 대해 상위 K개 옵션에서만 샘플링합니다. examples: - 5 minimum: 0 title: Top K top_p: type: number description: 핵 샘플링을 사용합니다. examples: - 0.7 minimum: 0 maximum: 1 title: Top P Message: type: object required: - id - type - role - content - model - stop_reason - stop_sequence - usage properties: id: type: string description: |- 고유 객체 식별자. ID의 형식과 길이는 시간이 지남에 따라 변경될 수 있습니다. examples: - msg_013Zva2CMHLNnXjNJJKqJ2EF title: Id type: type: string const: message description: |- 객체 유형. Messages의 경우, 항상 `"message"`입니다. title: 유형 role: type: string const: assistant description: |- 생성된 메시지의 대화 역할. 이 값은 항상 `"assistant"`입니다. title: 역할 content: type: array description: |- 모델이 생성한 콘텐츠. 이것은 콘텐츠 블록의 배열이며, 각 블록은 형태를 결정하는 `type`을 가지고 있습니다. items: anyOf: - $ref: '#/components/schemas/ResponseTextBlock' - $ref: '#/components/schemas/ResponseThinkingBlock' - $ref: '#/components/schemas/ResponseRedactedThinkingBlock' - $ref: '#/components/schemas/ResponseToolUseBlock' - $ref: '#/components/schemas/ResponseServerToolUseBlock' - $ref: '#/components/schemas/ResponseWebSearchToolResultBlock' - $ref: '#/components/schemas/ResponseWebFetchToolResultBlock' - $ref: '#/components/schemas/ResponseCodeExecutionToolResultBlock' - $ref: '#/components/schemas/ResponseBashCodeExecutionToolResultBlock' - $ref: >- #/components/schemas/ResponseTextEditorCodeExecutionToolResultBlock - $ref: '#/components/schemas/ResponseMCPToolUseBlock' - $ref: '#/components/schemas/ResponseMCPToolResultBlock' - $ref: '#/components/schemas/ResponseContainerUploadBlock' title: 콘텐츠 model: type: string description: 요청을 처리한 모델. enum: - claude-haiku-4-5-20251001 - claude-sonnet-4-5-20250929 - claude-opus-4-5-20251101 - claude-opus-4-6 - claude-fable-5 - claude-opus-4-8 - claude-opus-4-7 - claude-sonnet-4-6 - claude-sonnet-5 examples: - claude-opus-4-8 title: 트리거 시 제거해야 할 최소 토큰 수. 최소한 이만큼의 토큰을 제거할 수 있는 경우에만 컨텍스트가 수정됩니다. stop_reason: type: string nullable: true description: 중지 이유. enum: - end_turn - max_tokens - stop_sequence - tool_use - pause_turn - refusal - model_context_window_exceeded title: 중지 이유 stop_sequence: type: string nullable: true description: 생성된 사용자 정의 중지 시퀀스 (있는 경우). title: 중지 시퀀스 usage: $ref: '#/components/schemas/Usage' description: 과금 및 속도 제한 사용량. context_management: anyOf: - $ref: '#/components/schemas/ResponseContextManagement' - type: 'null' description: 컨텍스트 관리 응답. container: anyOf: - $ref: '#/components/schemas/Container' - type: 'null' description: 이 요청에 사용된 컨테이너 정보. InputMessage: additionalProperties: false properties: content: anyOf: - type: string - items: discriminator: mapping: bash_code_execution_tool_result: $ref: >- #/components/schemas/RequestBashCodeExecutionToolResultBlock code_execution_tool_result: $ref: '#/components/schemas/RequestCodeExecutionToolResultBlock' container_upload: $ref: '#/components/schemas/RequestContainerUploadBlock' document: $ref: '#/components/schemas/RequestDocumentBlock' image: $ref: '#/components/schemas/RequestImageBlock' mcp_tool_result: $ref: '#/components/schemas/RequestMCPToolResultBlock' mcp_tool_use: $ref: '#/components/schemas/RequestMCPToolUseBlock' redacted_thinking: $ref: '#/components/schemas/RequestRedactedThinkingBlock' search_result: $ref: '#/components/schemas/RequestSearchResultBlock' server_tool_use: $ref: '#/components/schemas/RequestServerToolUseBlock' text: $ref: '#/components/schemas/RequestTextBlock' text_editor_code_execution_tool_result: $ref: >- #/components/schemas/RequestTextEditorCodeExecutionToolResultBlock thinking: $ref: '#/components/schemas/RequestThinkingBlock' tool_result: $ref: '#/components/schemas/RequestToolResultBlock' tool_use: $ref: '#/components/schemas/RequestToolUseBlock' web_fetch_tool_result: $ref: '#/components/schemas/RequestWebFetchToolResultBlock' web_search_tool_result: $ref: '#/components/schemas/RequestWebSearchToolResultBlock' propertyName: type oneOf: - $ref: '#/components/schemas/RequestTextBlock' description: 일반 텍스트 콘텐츠. - $ref: '#/components/schemas/RequestImageBlock' description: base64 데이터로 직접 지정되거나 URL을 통해 참조되는 이미지 콘텐츠. - $ref: '#/components/schemas/RequestDocumentBlock' description: >- 문서 콘텐츠, base64 데이터로 직접 지정하거나, 텍스트로 지정하거나, URL을 통한 참조로 지정합니다. - $ref: '#/components/schemas/RequestSearchResultBlock' description: 검색 작업의 소스, 제목 및 콘텐츠를 포함하는 검색 결과 블록입니다. - $ref: '#/components/schemas/RequestThinkingBlock' description: 모델의 내부 사고를 지정하는 블록입니다. - $ref: '#/components/schemas/RequestRedactedThinkingBlock' description: 모델의 내부 수정된 사고를 지정하는 블록입니다. - $ref: '#/components/schemas/RequestToolUseBlock' description: 모델에 의한 도구 사용을 나타내는 블록입니다. - $ref: '#/components/schemas/RequestToolResultBlock' description: 모델의 도구 사용 결과를 지정하는 블록입니다. - $ref: '#/components/schemas/RequestServerToolUseBlock' - $ref: '#/components/schemas/RequestWebSearchToolResultBlock' - $ref: '#/components/schemas/RequestWebFetchToolResultBlock' - $ref: '#/components/schemas/RequestCodeExecutionToolResultBlock' - $ref: >- #/components/schemas/RequestBashCodeExecutionToolResultBlock - $ref: >- #/components/schemas/RequestTextEditorCodeExecutionToolResultBlock - $ref: '#/components/schemas/RequestMCPToolUseBlock' - $ref: '#/components/schemas/RequestMCPToolResultBlock' - $ref: '#/components/schemas/RequestContainerUploadBlock' type: array title: 콘텐츠 role: enum: - user - assistant title: 역할 type: string required: - content - role title: InputMessage type: object ContainerParams: additionalProperties: false description: 로드할 스킬이 포함된 컨테이너 파라미터. properties: id: anyOf: - type: string - type: 'null' description: Container id title: Id skills: anyOf: - items: $ref: '#/components/schemas/SkillParams' maxItems: 8 type: array - type: 'null' description: 컨테이너에 로드할 스킬 목록 title: 스킬 title: ContainerParams type: object ContextManagementConfig: additionalProperties: false properties: edits: description: 적용할 컨텍스트 관리 편집 목록 items: discriminator: mapping: clear_thinking_20251015: $ref: '#/components/schemas/ClearThinking20251015' clear_tool_uses_20250919: $ref: '#/components/schemas/ClearToolUses20250919' propertyName: type oneOf: - $ref: '#/components/schemas/ClearToolUses20250919' - $ref: '#/components/schemas/ClearThinking20251015' minItems: 0 title: 편집 type: array title: ContextManagementConfig type: object RequestMCPServerURLDefinition: additionalProperties: false properties: authorization_token: anyOf: - type: string - type: 'null' title: Authorization Token name: title: 이름 type: string tool_configuration: anyOf: - $ref: '#/components/schemas/RequestMCPServerToolConfiguration' - type: 'null' type: const: url title: 유형 type: string url: title: Url type: string required: - name - type - url title: RequestMCPServerURLDefinition type: object Metadata: additionalProperties: false properties: user_id: anyOf: - maxLength: 256 type: string - type: 'null' description: >- 요청과 연관된 사용자의 외부 식별자입니다. uuid, 해시 값 또는 기타 불투명 식별자여야 합니다. Anthropic은 이 ID를 남용 감지에 사용할 수 있습니다. 이름, 이메일 주소 또는 전화번호와 같은 식별 정보를 포함하지 마세요. examples: - 13803d75-b4b5-4c3e-b2a2-6f21399b021b title: 사용자 Id title: 메타데이터 type: object OutputConfig: additionalProperties: false properties: effort: description: 출력 노력 수준입니다. enum: - low - medium - high - xhigh - max title: Effort type: string format: $ref: '#/components/schemas/JSONOutputFormat' description: Claude 출력 형식을 제한하는 스키마입니다. task_budget: $ref: '#/components/schemas/TokenTaskBudget' description: 컨텍스트 전반의 총 토큰 예산입니다. title: OutputConfig type: object RequestTextBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control citations: anyOf: - items: discriminator: mapping: char_location: $ref: '#/components/schemas/RequestCharLocationCitation' content_block_location: $ref: '#/components/schemas/RequestContentBlockLocationCitation' page_location: $ref: '#/components/schemas/RequestPageLocationCitation' search_result_location: $ref: '#/components/schemas/RequestSearchResultLocationCitation' web_search_result_location: $ref: >- #/components/schemas/RequestWebSearchResultLocationCitation propertyName: type oneOf: - $ref: '#/components/schemas/RequestCharLocationCitation' - $ref: '#/components/schemas/RequestPageLocationCitation' - $ref: '#/components/schemas/RequestContentBlockLocationCitation' - $ref: >- #/components/schemas/RequestWebSearchResultLocationCitation - $ref: '#/components/schemas/RequestSearchResultLocationCitation' type: array - type: 'null' title: 인용 text: minLength: 1 title: 텍스트 type: string type: const: text title: 유형 type: string required: - text - type title: 텍스트 type: object ThinkingConfigEnabled: additionalProperties: false properties: budget_tokens: description: >- Claude가 내부 추론 과정에 사용할 수 있는 토큰 수를 결정합니다. 더 큰 예산은 복잡한 문제에 대해 더 철저한 분석을 가능하게 하여 응답 품질을 향상시킬 수 있습니다. ≥1024이고 `max_tokens`보다 작아야 합니다. 자세한 내용은 [확장 사고](https://docs.claude.com/ko/docs/build-with-claude/extended-thinking)를 참조하세요. minimum: 1024 title: Budget Tokens type: integer display: description: 응답에서 사고 내용이 표시되는 방식을 제어합니다. enum: - summarized - omitted title: 표시 type: string type: const: enabled title: 유형 type: string required: - budget_tokens - type title: |- 워터마크 활성화 **참고:** - `true`: 생성된 비디오에 워터마크 추가 - `false`: 워터마크 없음 (기본값) type: object ThinkingConfigAdaptive: additionalProperties: false properties: display: description: 응답에서 사고 내용이 표시되는 방식을 제어합니다. enum: - summarized - omitted title: 표시 type: string type: const: adaptive title: 유형 type: string required: - type title: Adaptive type: object ThinkingConfigDisabled: additionalProperties: false properties: type: const: disabled title: 유형 type: string required: - type title: 비활성화됨 type: object ToolChoiceAuto: additionalProperties: false description: 모델이 도구 사용 여부를 자동으로 결정합니다. properties: disable_parallel_tool_use: description: |- 병렬 도구 사용을 비활성화할지 여부. 기본값은 `false`입니다. `true`로 설정하면 모델은 최대 하나의 도구 사용만 출력합니다. title: 병렬 도구 사용 비활성화 type: boolean type: const: auto title: 유형 type: string required: - type title: Auto type: object ToolChoiceAny: additionalProperties: false description: 모델이 사용 가능한 모든 도구를 사용합니다. properties: disable_parallel_tool_use: description: |- 병렬 도구 사용을 비활성화할지 여부. 기본값은 `false`입니다. `true`로 설정하면 모델은 정확히 하나의 도구 사용만 출력합니다. title: 병렬 도구 사용 비활성화 type: boolean type: const: any title: 유형 type: string required: - type title: Any type: object ToolChoiceTool: additionalProperties: false description: 모델이 `tool_choice.name`으로 지정된 도구를 사용합니다. properties: disable_parallel_tool_use: description: |- 병렬 도구 사용을 비활성화할지 여부. 기본값은 `false`입니다. `true`로 설정하면 모델은 정확히 하나의 도구 사용만 출력합니다. title: 병렬 도구 사용 비활성화 type: boolean name: description: 사용할 도구의 이름. title: 이름 type: string type: const: tool title: 유형 type: string required: - name - type title: 도구 type: object ToolChoiceNone: additionalProperties: false description: 모델이 도구를 사용할 수 없습니다. properties: type: const: none title: 유형 type: string required: - type title: 없음 type: object Tool: additionalProperties: false properties: type: anyOf: - type: 'null' - const: custom type: string title: 유형 description: description: >- 이 도구가 수행하는 작업에 대한 설명. 도구 설명은 가능한 한 상세해야 합니다. 모델이 도구의 정체와 사용 방법에 대해 더 많은 정보를 가질수록 더 나은 성능을 발휘합니다. 자연어 설명을 사용하여 도구 입력 JSON 스키마의 중요한 측면을 강조할 수 있습니다. examples: - 주어진 위치의 현재 날씨를 가져옵니다 title: 설명 type: string name: description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. maxLength: 128 minLength: 1 pattern: ^[a-zA-Z0-9_-]{1,128}$ title: 이름 type: string input_schema: $ref: '#/components/schemas/InputSchema' description: |- 이 도구의 입력에 대한 [JSON schema](https://json-schema.org/draft/2020-12). 도구가 수락하고 모델이 생성할 `input`의 형태를 정의합니다. examples: - properties: location: description: '도시 및 주, 예: San Francisco, CA' type: string unit: description: 출력 단위 - (celsius, fahrenheit) 중 하나 type: string required: - location type: object cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control required: - name - input_schema title: 사용자 정의 도구 type: object BashTool_20241022: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control name: const: bash description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. title: 이름 type: string type: const: bash_20241022 title: 유형 type: string required: - name - type title: Bash tool (2024-10-22) type: object BashTool_20250124: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control name: const: bash description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. title: 이름 type: string type: const: bash_20250124 title: 유형 type: string required: - name - type title: Bash tool (2025-01-24) type: object CodeExecutionTool_20250522: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control name: const: code_execution description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. title: 이름 type: string type: const: code_execution_20250522 title: 유형 type: string required: - name - type title: Code execution tool (2025-05-22) type: object CodeExecutionTool_20250825: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control name: const: code_execution description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. title: 이름 type: string type: const: code_execution_20250825 title: 유형 type: string required: - name - type title: CodeExecutionTool_20250825 type: object ComputerUseTool_20241022: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control display_height_px: description: 디스플레이의 높이 (픽셀). minimum: 1 title: Display Height Px type: integer display_number: anyOf: - minimum: 0 type: integer - type: 'null' description: '디스플레이의 X11 디스플레이 번호 (예: 0, 1).' title: Display Number display_width_px: description: 디스플레이의 너비 (픽셀). minimum: 1 title: Display Width Px type: integer name: const: computer description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. title: 이름 type: string type: const: computer_20241022 title: 유형 type: string required: - display_height_px - display_width_px - name - type title: Computer use tool (2024-01-22) type: object MemoryTool_20250818: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control name: const: memory description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. title: 이름 type: string type: const: memory_20250818 title: 유형 type: string required: - name - type title: MemoryTool_20250818 type: object ComputerUseTool_20250124: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control display_height_px: description: 디스플레이의 높이 (픽셀). minimum: 1 title: Display Height Px type: integer display_number: anyOf: - minimum: 0 type: integer - type: 'null' description: '디스플레이의 X11 디스플레이 번호 (예: 0, 1).' title: Display Number display_width_px: description: 디스플레이의 너비 (픽셀). minimum: 1 title: Display Width Px type: integer name: const: computer description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. title: 이름 type: string type: const: computer_20250124 title: 유형 type: string required: - display_height_px - display_width_px - name - type title: Computer use tool (2025-01-24) type: object TextEditor_20241022: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control name: const: str_replace_editor description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. title: 이름 type: string type: const: text_editor_20241022 title: 유형 type: string required: - name - type title: 텍스트 편집기 도구 (2024-10-22) type: object TextEditor_20250124: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control name: const: str_replace_editor description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. title: 이름 type: string type: const: text_editor_20250124 title: 유형 type: string required: - name - type title: 텍스트 편집기 도구 (2025-01-24) type: object TextEditor_20250429: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control name: const: str_replace_based_edit_tool description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. title: 이름 type: string type: const: text_editor_20250429 title: 유형 type: string required: - name - type title: 텍스트 편집기 도구 (2025-04-29) type: object TextEditor_20250728: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control max_characters: anyOf: - minimum: 1 type: integer - type: 'null' description: 파일 조회 시 표시할 최대 문자 수. 지정하지 않으면 전체 파일이 표시됩니다. title: 최대 문자 수 name: const: str_replace_based_edit_tool description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. title: 이름 type: string type: const: text_editor_20250728 title: 유형 type: string required: - name - type title: TextEditor_20250728 type: object WebSearchTool_20250305: additionalProperties: false properties: allowed_domains: anyOf: - items: type: string type: array - type: 'null' description: 제공된 경우, 이 도메인만 결과에 포함됩니다. `blocked_domains`와 함께 사용할 수 없습니다. title: 허용된 도메인 blocked_domains: anyOf: - items: type: string type: array - type: 'null' description: 제공된 경우, 이 도메인은 결과에 표시되지 않습니다. `allowed_domains`와 함께 사용할 수 없습니다. title: 차단된 도메인 cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control max_uses: anyOf: - exclusiveMinimum: 0 type: integer - type: 'null' description: API 요청에서 도구를 사용할 수 있는 최대 횟수. title: 최대 사용 횟수 name: const: web_search description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. title: 이름 type: string type: const: web_search_20250305 title: 유형 type: string user_location: anyOf: - $ref: '#/components/schemas/UserLocation' - type: 'null' description: 사용자 위치에 대한 매개변수. 더 관련성 높은 검색 결과를 제공하는 데 사용됩니다. required: - name - type title: 웹 검색 도구 (2025-03-05) type: object WebFetchTool_20250910: additionalProperties: false properties: allowed_domains: anyOf: - items: type: string type: array - type: 'null' description: 가져오기를 허용할 도메인 목록 title: 허용된 도메인 blocked_domains: anyOf: - items: type: string type: array - type: 'null' description: 가져오기를 차단할 도메인 목록 title: 차단된 도메인 cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control citations: anyOf: - $ref: '#/components/schemas/RequestCitationsConfig' - type: 'null' description: 가져온 문서에 대한 인용 설정. 인용은 기본적으로 비활성화되어 있습니다. max_content_tokens: anyOf: - exclusiveMinimum: 0 type: integer - type: 'null' description: >- 웹 페이지 텍스트 콘텐츠를 컨텍스트에 포함하여 사용하는 최대 토큰 수. 이 제한은 근사치이며 PDF와 같은 바이너리 콘텐츠에는 적용되지 않습니다. title: 최대 콘텐츠 토큰 max_uses: anyOf: - exclusiveMinimum: 0 type: integer - type: 'null' description: API 요청에서 도구를 사용할 수 있는 최대 횟수. title: 최대 사용 횟수 name: const: web_fetch description: |- 도구의 이름. 모델이 `tool_use` 블록에서 도구를 호출하는 데 사용하는 이름입니다. title: 이름 type: string type: const: web_fetch_20250910 title: 유형 type: string required: - name - type title: WebFetchTool_20250910 type: object ResponseTextBlock: properties: citations: anyOf: - items: discriminator: mapping: char_location: $ref: '#/components/schemas/ResponseCharLocationCitation' content_block_location: $ref: >- #/components/schemas/ResponseContentBlockLocationCitation page_location: $ref: '#/components/schemas/ResponsePageLocationCitation' search_result_location: $ref: >- #/components/schemas/ResponseSearchResultLocationCitation web_search_result_location: $ref: >- #/components/schemas/ResponseWebSearchResultLocationCitation propertyName: type oneOf: - $ref: '#/components/schemas/ResponseCharLocationCitation' - $ref: '#/components/schemas/ResponsePageLocationCitation' - $ref: '#/components/schemas/ResponseContentBlockLocationCitation' - $ref: >- #/components/schemas/ResponseWebSearchResultLocationCitation - $ref: '#/components/schemas/ResponseSearchResultLocationCitation' type: array - type: 'null' default: null description: >- 텍스트 블록을 지원하는 인용. 반환되는 인용 유형은 인용되는 문서 유형에 따라 달라집니다. PDF를 인용하면 `page_location`이, 일반 텍스트를 인용하면 `char_location`이, 콘텐츠 문서를 인용하면 `content_block_location`이 반환됩니다. title: 인용 text: maxLength: 5000000 minLength: 0 title: 텍스트 type: string type: const: text default: text title: 유형 type: string required: - citations - text - type title: 텍스트 type: object ResponseThinkingBlock: properties: signature: title: 서명 type: string thinking: title: 사고 type: string type: const: thinking default: thinking title: 유형 type: string required: - signature - thinking - type title: 사고 type: object ResponseRedactedThinkingBlock: properties: data: title: 데이터 type: string type: const: redacted_thinking default: redacted_thinking title: 유형 type: string required: - data - type title: 수정된 사고 type: object ResponseToolUseBlock: properties: id: pattern: ^[a-zA-Z0-9_-]+$ title: Id type: string input: additionalProperties: true title: 입력 type: object name: minLength: 1 title: 이름 type: string type: const: tool_use default: tool_use title: 유형 type: string required: - id - input - name - type title: 도구 사용 type: object ResponseServerToolUseBlock: properties: id: pattern: ^srvtoolu_[a-zA-Z0-9_]+$ title: Id type: string input: additionalProperties: true title: 입력 type: object name: enum: - web_search - web_fetch - code_execution - bash_code_execution - text_editor_code_execution title: 이름 type: string type: const: server_tool_use default: server_tool_use title: 유형 type: string required: - id - input - name - type title: 서버 도구 사용 type: object ResponseWebSearchToolResultBlock: properties: content: anyOf: - $ref: '#/components/schemas/ResponseWebSearchToolResultError' - items: $ref: '#/components/schemas/ResponseWebSearchResultBlock' type: array title: 콘텐츠 tool_use_id: pattern: ^srvtoolu_[a-zA-Z0-9_]+$ title: 도구 사용 Id type: string type: const: web_search_tool_result default: web_search_tool_result title: 유형 type: string required: - content - tool_use_id - type title: 웹 검색 도구 결과 type: object ResponseWebFetchToolResultBlock: properties: content: anyOf: - $ref: '#/components/schemas/ResponseWebFetchToolResultError' - $ref: '#/components/schemas/ResponseWebFetchResultBlock' title: 콘텐츠 tool_use_id: pattern: ^srvtoolu_[a-zA-Z0-9_]+$ title: 도구 사용 Id type: string type: const: web_fetch_tool_result default: web_fetch_tool_result title: 유형 type: string required: - content - tool_use_id - type title: ResponseWebFetchToolResultBlock type: object ResponseCodeExecutionToolResultBlock: properties: content: anyOf: - $ref: '#/components/schemas/ResponseCodeExecutionToolResultError' - $ref: '#/components/schemas/ResponseCodeExecutionResultBlock' title: 콘텐츠 tool_use_id: pattern: ^srvtoolu_[a-zA-Z0-9_]+$ title: 도구 사용 Id type: string type: const: code_execution_tool_result default: code_execution_tool_result title: 유형 type: string required: - content - tool_use_id - type title: 코드 실행 도구 결과 type: object ResponseBashCodeExecutionToolResultBlock: properties: content: anyOf: - $ref: '#/components/schemas/ResponseBashCodeExecutionToolResultError' - $ref: '#/components/schemas/ResponseBashCodeExecutionResultBlock' title: 콘텐츠 tool_use_id: pattern: ^srvtoolu_[a-zA-Z0-9_]+$ title: 도구 사용 Id type: string type: const: bash_code_execution_tool_result default: bash_code_execution_tool_result title: 유형 type: string required: - content - tool_use_id - type title: ResponseBashCodeExecutionToolResultBlock type: object ResponseTextEditorCodeExecutionToolResultBlock: properties: content: anyOf: - $ref: >- #/components/schemas/ResponseTextEditorCodeExecutionToolResultError - $ref: >- #/components/schemas/ResponseTextEditorCodeExecutionViewResultBlock - $ref: >- #/components/schemas/ResponseTextEditorCodeExecutionCreateResultBlock - $ref: >- #/components/schemas/ResponseTextEditorCodeExecutionStrReplaceResultBlock title: 콘텐츠 tool_use_id: pattern: ^srvtoolu_[a-zA-Z0-9_]+$ title: 도구 사용 Id type: string type: const: text_editor_code_execution_tool_result default: text_editor_code_execution_tool_result title: 유형 type: string required: - content - tool_use_id - type title: ResponseTextEditorCodeExecutionToolResultBlock type: object ResponseMCPToolUseBlock: properties: id: pattern: ^[a-zA-Z0-9_-]+$ title: Id type: string input: additionalProperties: true title: 입력 type: object name: description: MCP 도구의 이름 title: 이름 type: string server_name: description: MCP 서버의 이름 title: 서버 이름 type: string type: const: mcp_tool_use default: mcp_tool_use title: 유형 type: string required: - id - input - name - server_name - type title: MCP 도구 사용 type: object ResponseMCPToolResultBlock: properties: content: anyOf: - type: string - items: $ref: '#/components/schemas/ResponseTextBlock' type: array title: 콘텐츠 is_error: default: false title: 오류 여부 type: boolean tool_use_id: pattern: ^[a-zA-Z0-9_-]+$ title: 도구 사용 Id type: string type: const: mcp_tool_result default: mcp_tool_result title: 유형 type: string required: - content - is_error - tool_use_id - type title: |- Tool Use 또는 Function Calling을 위한 도구 목록 **참고**: - 각 도구에는 type이 포함되어야 합니다 - function 구조에는 name, description, parameters가 포함되어야 합니다 - tools 배열에 최대 128개의 함수 type: object ResponseContainerUploadBlock: description: 컨테이너에 업로드된 파일의 응답 모델. properties: file_id: title: File Id type: string type: const: container_upload default: container_upload title: 유형 type: string required: - file_id - type title: 컨테이너 업로드 type: object Usage: properties: cache_creation: anyOf: - $ref: '#/components/schemas/CacheCreation' - type: 'null' default: null description: TTL별 캐시된 토큰 분류 cache_creation_input_tokens: anyOf: - minimum: 0 type: integer - type: 'null' default: null description: 캐시 항목을 생성하는 데 사용된 입력 토큰 수. examples: - 2051 title: Cache Creation Input Tokens cache_read_input_tokens: anyOf: - minimum: 0 type: integer - type: 'null' default: null description: 캐시에서 읽은 입력 토큰 수. examples: - 2051 title: Cache Read Input Tokens input_tokens: description: 사용된 입력 토큰 수. examples: - 2095 minimum: 0 title: 입력 토큰 type: integer output_tokens: description: 사용된 출력 토큰 수. examples: - 503 minimum: 0 title: |- 편집을 위한 원본 비디오 URL 목록 **참고:** - 요청당 `1`개의 비디오만 가능 - 지원 비디오 길이: `3`~`10`초 (3초 미만 비디오는 3초로 과금, 10초 초과 비디오는 10초로 과금) - 비디오 크기: 최대 `100MB` - 지원 형식: `.mp4`, `.mov` - 비디오 URL은 서버에서 직접 접근 가능해야 합니다 type: integer server_tool_use: anyOf: - $ref: '#/components/schemas/ServerToolUsage' - type: 'null' default: null description: 서버 도구 요청 수. service_tier: anyOf: - enum: - standard - priority - batch type: string - type: 'null' default: null description: 요청이 priority, standard 또는 batch 티어를 사용했는지 여부. title: 서비스 티어 required: - cache_creation - cache_creation_input_tokens - cache_read_input_tokens - input_tokens - output_tokens - server_tool_use - service_tier title: 사용량 type: object ResponseContextManagement: properties: applied_edits: description: 적용된 컨텍스트 관리 편집 목록. items: discriminator: mapping: clear_thinking_20251015: $ref: '#/components/schemas/ResponseClearThinking20251015Edit' clear_tool_uses_20250919: $ref: '#/components/schemas/ResponseClearToolUses20250919Edit' propertyName: type oneOf: - $ref: '#/components/schemas/ResponseClearToolUses20250919Edit' - $ref: '#/components/schemas/ResponseClearThinking20251015Edit' title: 적용된 편집 type: array required: - applied_edits title: ResponseContextManagement type: object Container: description: 요청에 사용된 컨테이너 정보 (코드 실행 도구용) properties: expires_at: description: 컨테이너가 만료되는 시간. format: date-time title: Expires At type: string id: description: 이 요청에 사용된 컨테이너의 식별자 title: Id type: string skills: anyOf: - items: $ref: '#/components/schemas/Skill' type: array - type: 'null' default: null description: 컨테이너에 로드된 스킬 title: 스킬 required: - expires_at - id - skills title: Container type: object RequestBashCodeExecutionToolResultBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control content: anyOf: - $ref: '#/components/schemas/RequestBashCodeExecutionToolResultError' - $ref: '#/components/schemas/RequestBashCodeExecutionResultBlock' title: 콘텐츠 tool_use_id: pattern: ^srvtoolu_[a-zA-Z0-9_]+$ title: 도구 사용 Id type: string type: const: bash_code_execution_tool_result title: 유형 type: string required: - content - tool_use_id - type title: RequestBashCodeExecutionToolResultBlock type: object RequestCodeExecutionToolResultBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control content: anyOf: - $ref: '#/components/schemas/RequestCodeExecutionToolResultError' - $ref: '#/components/schemas/RequestCodeExecutionResultBlock' title: 콘텐츠 tool_use_id: pattern: ^srvtoolu_[a-zA-Z0-9_]+$ title: 도구 사용 Id type: string type: const: code_execution_tool_result title: 유형 type: string required: - content - tool_use_id - type title: 코드 실행 도구 결과 type: object RequestContainerUploadBlock: additionalProperties: false description: |- 컨테이너에 업로드할 파일을 나타내는 콘텐츠 블록입니다. 이 블록을 통해 업로드된 파일은 컨테이너의 입력 디렉토리에서 사용할 수 있습니다. properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control file_id: title: File Id type: string type: const: container_upload title: 유형 type: string required: - file_id - type title: 컨테이너 업로드 type: object RequestDocumentBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control citations: anyOf: - $ref: '#/components/schemas/RequestCitationsConfig' - type: 'null' context: anyOf: - minLength: 1 type: string - type: 'null' title: 컨텍스트 source: discriminator: mapping: base64: $ref: '#/components/schemas/Base64PDFSource' content: $ref: '#/components/schemas/ContentBlockSource' file: $ref: '#/components/schemas/FileDocumentSource' text: $ref: '#/components/schemas/PlainTextSource' propertyName: type oneOf: - $ref: '#/components/schemas/Base64PDFSource' - $ref: '#/components/schemas/PlainTextSource' - $ref: '#/components/schemas/ContentBlockSource' - $ref: '#/components/schemas/FileDocumentSource' title: anyOf: - maxLength: 500 minLength: 1 type: string - type: 'null' title: 제목 type: const: document title: 유형 type: string required: - source - type title: 문서 type: object RequestImageBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control source: discriminator: mapping: base64: $ref: '#/components/schemas/Base64ImageSource' file: $ref: '#/components/schemas/FileImageSource' propertyName: type oneOf: - $ref: '#/components/schemas/Base64ImageSource' - $ref: '#/components/schemas/FileImageSource' title: 소스 type: const: image title: 유형 type: string required: - source - type title: 이미지 type: object RequestMCPToolResultBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control content: anyOf: - type: string - type: array items: $ref: '#/components/schemas/RequestTextBlock' title: 콘텐츠 is_error: title: 오류 여부 type: boolean tool_use_id: pattern: ^[a-zA-Z0-9_-]+$ title: 도구 사용 Id type: string type: const: mcp_tool_result title: 유형 type: string required: - tool_use_id - type title: |- Tool Use 또는 Function Calling을 위한 도구 목록 **참고**: - 각 도구에는 type이 포함되어야 합니다 - function 구조에는 name, description, parameters가 포함되어야 합니다 - tools 배열에 최대 128개의 함수 type: object RequestMCPToolUseBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control id: pattern: ^[a-zA-Z0-9_-]+$ title: Id type: string input: additionalProperties: true title: 입력 type: object name: title: 이름 type: string server_name: description: MCP 서버의 이름 title: 서버 이름 type: string type: const: mcp_tool_use title: 유형 type: string required: - id - input - name - server_name - type title: MCP 도구 사용 type: object RequestRedactedThinkingBlock: additionalProperties: false properties: data: title: 데이터 type: string type: const: redacted_thinking title: 유형 type: string required: - data - type title: 수정된 사고 type: object RequestSearchResultBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control citations: $ref: '#/components/schemas/RequestCitationsConfig' content: items: $ref: '#/components/schemas/RequestTextBlock' title: 콘텐츠 type: array source: title: 소스 type: string title: title: 제목 type: string type: const: search_result title: 유형 type: string required: - content - source - title - type title: 검색 결과 type: object RequestServerToolUseBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control id: pattern: ^srvtoolu_[a-zA-Z0-9_]+$ title: Id type: string input: additionalProperties: true title: 입력 type: object name: enum: - web_search - web_fetch - code_execution - bash_code_execution - text_editor_code_execution title: 이름 type: string type: const: server_tool_use title: 유형 type: string required: - id - input - name - type title: 서버 도구 사용 type: object RequestTextEditorCodeExecutionToolResultBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control content: anyOf: - $ref: >- #/components/schemas/RequestTextEditorCodeExecutionToolResultError - $ref: >- #/components/schemas/RequestTextEditorCodeExecutionViewResultBlock - $ref: >- #/components/schemas/RequestTextEditorCodeExecutionCreateResultBlock - $ref: >- #/components/schemas/RequestTextEditorCodeExecutionStrReplaceResultBlock title: 콘텐츠 tool_use_id: pattern: ^srvtoolu_[a-zA-Z0-9_]+$ title: 도구 사용 Id type: string type: const: text_editor_code_execution_tool_result title: 유형 type: string required: - content - tool_use_id - type title: RequestTextEditorCodeExecutionToolResultBlock type: object RequestThinkingBlock: additionalProperties: false properties: signature: title: 서명 type: string thinking: title: 사고 type: string type: const: thinking title: 유형 type: string required: - signature - thinking - type title: 사고 type: object RequestToolResultBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control content: anyOf: - type: string - items: discriminator: mapping: document: $ref: '#/components/schemas/RequestDocumentBlock' image: $ref: '#/components/schemas/RequestImageBlock' search_result: $ref: '#/components/schemas/RequestSearchResultBlock' text: $ref: '#/components/schemas/RequestTextBlock' propertyName: type oneOf: - $ref: '#/components/schemas/RequestTextBlock' - $ref: '#/components/schemas/RequestImageBlock' - $ref: '#/components/schemas/RequestSearchResultBlock' - $ref: '#/components/schemas/RequestDocumentBlock' type: array title: 콘텐츠 is_error: title: 오류 여부 type: boolean tool_use_id: pattern: ^[a-zA-Z0-9_-]+$ title: 도구 사용 Id type: string type: const: tool_result title: 유형 type: string required: - tool_use_id - type title: 도구 결과 type: object RequestToolUseBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control id: pattern: ^[a-zA-Z0-9_-]+$ title: Id type: string input: additionalProperties: true title: 입력 type: object name: maxLength: 200 minLength: 1 title: 이름 type: string type: const: tool_use title: 유형 type: string required: - id - input - name - type title: 도구 사용 type: object RequestWebFetchToolResultBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control content: anyOf: - $ref: '#/components/schemas/RequestWebFetchToolResultError' - $ref: '#/components/schemas/RequestWebFetchResultBlock' title: 콘텐츠 tool_use_id: pattern: ^srvtoolu_[a-zA-Z0-9_]+$ title: 도구 사용 Id type: string type: const: web_fetch_tool_result title: 유형 type: string required: - content - tool_use_id - type title: RequestWebFetchToolResultBlock type: object RequestWebSearchToolResultBlock: additionalProperties: false properties: cache_control: anyOf: - discriminator: mapping: ephemeral: $ref: '#/components/schemas/CacheControlEphemeral' propertyName: type oneOf: - $ref: '#/components/schemas/CacheControlEphemeral' - type: 'null' description: 이 콘텐츠 블록에 캐시 제어 중단점을 생성합니다. title: Cache Control content: anyOf: - items: $ref: '#/components/schemas/RequestWebSearchResultBlock' type: array - $ref: '#/components/schemas/RequestWebSearchToolResultError' title: 콘텐츠 tool_use_id: pattern: ^srvtoolu_[a-zA-Z0-9_]+$ title: 도구 사용 Id type: string type: const: web_search_tool_result title: 유형 type: string required: - content - tool_use_id - type title: 웹 검색 도구 결과 type: object SkillParams: additionalProperties: false description: 컨테이너에 로드할 스킬의 사양 (요청 모델). properties: skill_id: description: 스킬 ID maxLength: 64 minLength: 1 title: 스킬 Id type: string type: description: 스킬 유형 - 'anthropic' (내장) 또는 'custom' (사용자 정의) enum: - anthropic - custom title: 유형 type: string version: description: 스킬 버전 또는 최신 버전의 경우 'latest' maxLength: 64 minLength: 1 title: 버전 type: string required: - skill_id - type title: SkillParams type: object ClearThinking20251015: additionalProperties: false properties: keep: anyOf: - discriminator: mapping: all: $ref: '#/components/schemas/AllThinkingTurns' thinking_turns: $ref: '#/components/schemas/ThinkingTurns' propertyName: type oneOf: - $ref: '#/components/schemas/ThinkingTurns' - $ref: '#/components/schemas/AllThinkingTurns' - const: all type: string description: 사고 블록을 유지할 최근 어시스턴트 턴 수. 이전 턴의 사고 블록은 제거됩니다. title: 유지 type: const: clear_thinking_20251015 title: 유형 type: string required: - type title: ClearThinking20251015 type: object ClearToolUses20250919: additionalProperties: false properties: clear_at_least: anyOf: - $ref: '#/components/schemas/InputTokensClearAtLeast' - type: 'null' description: 트리거 시 제거해야 할 최소 토큰 수. 최소한 이만큼의 토큰을 제거할 수 있는 경우에만 컨텍스트가 수정됩니다. clear_tool_inputs: anyOf: - type: boolean - items: type: string type: array - type: 'null' description: 모든 도구 입력을 지울지 (bool) 또는 지울 특정 도구 입력 (list) title: Clear Tool Inputs exclude_tools: anyOf: - items: type: string type: array - type: 'null' description: 삭제에서 보존되는 도구 사용의 도구 이름 title: Exclude Tools keep: description: 대화에서 유지할 도구 사용 수 discriminator: mapping: tool_uses: $ref: '#/components/schemas/ToolUsesKeep' propertyName: type oneOf: - $ref: '#/components/schemas/ToolUsesKeep' title: 유지 trigger: description: 컨텍스트 관리 전략을 트리거하는 조건 discriminator: mapping: input_tokens: $ref: '#/components/schemas/InputTokensTrigger' tool_uses: $ref: '#/components/schemas/ToolUsesTrigger' propertyName: type oneOf: - $ref: '#/components/schemas/InputTokensTrigger' - $ref: '#/components/schemas/ToolUsesTrigger' title: 트리거 type: const: clear_tool_uses_20250919 title: 유형 type: string required: - type title: ClearToolUses20250919 type: object RequestMCPServerToolConfiguration: additionalProperties: false properties: allowed_tools: anyOf: - items: type: string type: array - type: 'null' title: 허용된 도구 enabled: anyOf: - type: boolean - type: 'null' title: |- 워터마크 활성화 **참고:** - `true`: 생성된 비디오에 워터마크 추가 - `false`: 워터마크 없음 (기본값) title: RequestMCPServerToolConfiguration type: object JSONOutputFormat: additionalProperties: false properties: schema: description: Claude 출력을 정의하는 JSON 스키마입니다. type: object type: const: json_schema title: Type type: string required: - schema - type title: JSONOutputFormat type: object TokenTaskBudget: additionalProperties: false properties: remaining: description: 남은 토큰 예산입니다. minimum: 0 title: Remaining type: integer total: description: 컨텍스트 전반의 총 토큰 예산입니다. minimum: 20000 title: Total type: integer type: const: tokens title: Type type: string required: - total - type title: TokenTaskBudget type: object CacheControlEphemeral: additionalProperties: false properties: type: const: ephemeral title: 유형 type: string required: - type title: CacheControlEphemeral type: object RequestCharLocationCitation: additionalProperties: false properties: cited_text: title: 인용된 텍스트 type: string document_index: minimum: 0 title: 문서 인덱스 type: integer document_title: anyOf: - maxLength: 255 minLength: 1 type: string - type: 'null' title: 문서 제목 end_char_index: title: 종료 턴 인덱스 (배타적) type: integer start_char_index: minimum: 0 title: 시작 문자 인덱스 type: integer type: const: char_location title: 유형 type: string required: - cited_text - document_index - document_title - end_char_index - start_char_index - type title: 캐릭터 위치 type: object RequestContentBlockLocationCitation: additionalProperties: false properties: cited_text: title: 인용된 텍스트 type: string document_index: minimum: 0 title: 문서 인덱스 type: integer document_title: anyOf: - maxLength: 255 minLength: 1 type: string - type: 'null' title: 문서 제목 end_block_index: title: 종료 페이지 (배타적) type: integer start_block_index: minimum: 0 title: 시작 블록 인덱스 type: integer type: const: content_block_location title: 유형 type: string required: - cited_text - document_index - document_title - end_block_index - start_block_index - type title: 콘텐츠 블록 위치 type: object RequestPageLocationCitation: additionalProperties: false properties: cited_text: title: 인용된 텍스트 type: string document_index: minimum: 0 title: 문서 인덱스 type: integer document_title: anyOf: - maxLength: 255 minLength: 1 type: string - type: 'null' title: 문서 제목 end_page_number: title: 환경 이름 type: integer start_page_number: minimum: 1 title: 시작 페이지 번호 type: integer type: const: page_location title: 유형 type: string required: - cited_text - document_index - document_title - end_page_number - start_page_number - type title: 페이지 위치 type: object RequestSearchResultLocationCitation: additionalProperties: false properties: cited_text: title: 인용된 텍스트 type: string end_block_index: title: 종료 페이지 (배타적) type: integer search_result_index: minimum: 0 title: 검색 결과 인덱스 type: integer source: title: 소스 type: string start_block_index: minimum: 0 title: 시작 블록 인덱스 type: integer title: anyOf: - type: string - type: 'null' title: 제목 type: const: search_result_location title: 유형 type: string required: - cited_text - end_block_index - search_result_index - source - start_block_index - title - type title: RequestSearchResultLocationCitation type: object RequestWebSearchResultLocationCitation: additionalProperties: false properties: cited_text: title: 인용된 텍스트 type: string encrypted_index: title: 종료 인덱스 (배타적) type: string title: anyOf: - maxLength: 512 minLength: 1 type: string - type: 'null' title: 제목 type: const: web_search_result_location title: 유형 type: string url: maxLength: 2048 minLength: 1 title: Url type: string required: - cited_text - encrypted_index - title - type - url title: RequestWebSearchResultLocationCitation type: object InputSchema: additionalProperties: true properties: properties: anyOf: - additionalProperties: true type: object - type: 'null' title: 속성 required: anyOf: - items: type: string type: array - type: 'null' title: 필수 type: const: object title: 유형 type: string required: - type title: InputSchema type: object UserLocation: additionalProperties: false properties: city: anyOf: - maxLength: 255 minLength: 1 type: string - type: 'null' description: 사용자의 도시. examples: - New York - Tokyo - Los Angeles title: 도시 country: anyOf: - maxLength: 2 minLength: 2 type: string - type: 'null' description: >- 사용자의 두 글자 [ISO 국가 코드](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). examples: - US - JP - GB title: 국가 region: anyOf: - maxLength: 255 minLength: 1 type: string - type: 'null' description: 사용자의 지역. examples: - California - Ontario - Wales title: 참조 이미지, 최대 3개, 각 최대 10MB timezone: anyOf: - maxLength: 255 minLength: 1 type: string - type: 'null' description: 사용자의 [IANA 시간대](https://nodatime.org/TimeZones). examples: - America/New_York - Asia/Tokyo - Europe/London title: 시간대 type: const: approximate title: 유형 type: string required: - type title: UserLocation type: object RequestCitationsConfig: additionalProperties: false properties: enabled: title: |- 워터마크 활성화 **참고:** - `true`: 생성된 비디오에 워터마크 추가 - `false`: 워터마크 없음 (기본값) type: boolean title: RequestCitationsConfig type: object ResponseCharLocationCitation: properties: cited_text: title: 인용된 텍스트 type: string document_index: minimum: 0 title: 문서 인덱스 type: integer document_title: anyOf: - type: string - type: 'null' title: 문서 제목 end_char_index: title: 종료 턴 인덱스 (배타적) type: integer file_id: anyOf: - type: string - type: 'null' default: null title: File Id start_char_index: minimum: 0 title: 시작 문자 인덱스 type: integer type: const: char_location default: char_location title: 유형 type: string required: - cited_text - document_index - document_title - end_char_index - file_id - start_char_index - type title: 캐릭터 위치 type: object ResponseContentBlockLocationCitation: properties: cited_text: title: 인용된 텍스트 type: string document_index: minimum: 0 title: 문서 인덱스 type: integer document_title: anyOf: - type: string - type: 'null' title: 문서 제목 end_block_index: title: 종료 페이지 (배타적) type: integer file_id: anyOf: - type: string - type: 'null' default: null title: File Id start_block_index: minimum: 0 title: 시작 블록 인덱스 type: integer type: const: content_block_location default: content_block_location title: 유형 type: string required: - cited_text - document_index - document_title - end_block_index - file_id - start_block_index - type title: 콘텐츠 블록 위치 type: object ResponsePageLocationCitation: properties: cited_text: title: 인용된 텍스트 type: string document_index: minimum: 0 title: 문서 인덱스 type: integer document_title: anyOf: - type: string - type: 'null' title: 문서 제목 end_page_number: title: 환경 이름 type: integer file_id: anyOf: - type: string - type: 'null' default: null title: File Id start_page_number: minimum: 1 title: 시작 페이지 번호 type: integer type: const: page_location default: page_location title: 유형 type: string required: - cited_text - document_index - document_title - end_page_number - file_id - start_page_number - type title: 페이지 위치 type: object ResponseSearchResultLocationCitation: properties: cited_text: title: 인용된 텍스트 type: string end_block_index: title: 종료 페이지 (배타적) type: integer search_result_index: minimum: 0 title: 검색 결과 인덱스 type: integer source: title: 소스 type: string start_block_index: minimum: 0 title: 시작 블록 인덱스 type: integer title: anyOf: - type: string - type: 'null' title: 제목 type: const: search_result_location default: search_result_location title: 유형 type: string required: - cited_text - end_block_index - search_result_index - source - start_block_index - title - type title: ResponseSearchResultLocationCitation type: object ResponseWebSearchResultLocationCitation: properties: cited_text: title: 인용된 텍스트 type: string encrypted_index: title: 종료 인덱스 (배타적) type: string title: anyOf: - maxLength: 512 type: string - type: 'null' title: 제목 type: const: web_search_result_location default: web_search_result_location title: 유형 type: string url: title: Url type: string required: - cited_text - encrypted_index - title - type - url title: ResponseWebSearchResultLocationCitation type: object ResponseWebSearchToolResultError: properties: error_code: $ref: '#/components/schemas/WebSearchToolResultErrorCode' type: const: web_search_tool_result_error default: web_search_tool_result_error title: 유형 type: string required: - error_code - type title: ResponseWebSearchToolResultError type: object ResponseWebSearchResultBlock: properties: encrypted_content: title: 종료 인덱스 type: string page_age: anyOf: - type: string - type: 'null' default: null title: 페이지 연령 title: title: 제목 type: string type: const: web_search_result default: web_search_result title: 유형 type: string url: title: Url type: string required: - encrypted_content - page_age - title - type - url title: ResponseWebSearchResultBlock type: object ResponseWebFetchToolResultError: properties: error_code: $ref: '#/components/schemas/WebFetchToolResultErrorCode' type: const: web_fetch_tool_result_error default: web_fetch_tool_result_error title: 유형 type: string required: - error_code - type title: ResponseWebFetchToolResultError type: object ResponseWebFetchResultBlock: properties: content: $ref: '#/components/schemas/ResponseDocumentBlock' retrieved_at: anyOf: - type: string - type: 'null' default: null description: 콘텐츠가 검색된 ISO 8601 타임스탬프 title: 검색 시간 type: const: web_fetch_result default: web_fetch_result title: 유형 type: string url: description: 가져온 콘텐츠 URL title: Url type: string required: - content - retrieved_at - type - url title: ResponseWebFetchResultBlock type: object ResponseCodeExecutionToolResultError: properties: error_code: $ref: '#/components/schemas/CodeExecutionToolResultErrorCode' type: const: code_execution_tool_result_error default: code_execution_tool_result_error title: 유형 type: string required: - error_code - type title: 코드 실행 도구 오류 type: object ResponseCodeExecutionResultBlock: properties: content: items: $ref: '#/components/schemas/ResponseCodeExecutionOutputBlock' title: 콘텐츠 type: array return_code: title: 반환 코드 type: integer stderr: title: Stderr type: string stdout: title: Stdout type: string type: const: code_execution_result default: code_execution_result title: 유형 type: string required: - content - return_code - stderr - stdout - type title: 코드 실행 결과 type: object ResponseBashCodeExecutionToolResultError: properties: error_code: $ref: '#/components/schemas/BashCodeExecutionToolResultErrorCode' type: const: bash_code_execution_tool_result_error default: bash_code_execution_tool_result_error title: 유형 type: string required: - error_code - type title: ResponseBashCodeExecutionToolResultError type: object ResponseBashCodeExecutionResultBlock: properties: content: items: $ref: '#/components/schemas/ResponseBashCodeExecutionOutputBlock' title: 콘텐츠 type: array return_code: title: 반환 코드 type: integer stderr: title: Stderr type: string stdout: title: Stdout type: string type: const: bash_code_execution_result default: bash_code_execution_result title: 유형 type: string required: - content - return_code - stderr - stdout - type title: ResponseBashCodeExecutionResultBlock type: object ResponseTextEditorCodeExecutionToolResultError: properties: error_code: $ref: '#/components/schemas/TextEditorCodeExecutionToolResultErrorCode' error_message: anyOf: - type: string - type: 'null' default: null title: '오류 코드 (예: invalid_api_key, insufficient_credits)' type: const: text_editor_code_execution_tool_result_error default: text_editor_code_execution_tool_result_error title: 유형 type: string required: - error_code - error_message - type title: ResponseTextEditorCodeExecutionToolResultError type: object ResponseTextEditorCodeExecutionViewResultBlock: properties: content: title: 콘텐츠 type: string file_type: enum: - text - image - pdf title: 파일 유형 type: string num_lines: anyOf: - type: integer - type: 'null' default: null title: |- Nucleus sampling 매개변수 **참고**: - 누적 확률에서 토큰 샘플링을 제어합니다 - 예를 들어, 0.9는 상위 90% 누적 확률의 토큰에서 샘플링하는 것을 의미합니다 - 기본값: 1.0 (모든 토큰 고려) **권장사항**: temperature와 top_p를 동시에 조정하지 마세요 start_line: anyOf: - type: integer - type: 'null' default: null title: 시작 줄 total_lines: anyOf: - type: integer - type: 'null' default: null title: 총 줄 수 type: const: text_editor_code_execution_view_result default: text_editor_code_execution_view_result title: 유형 type: string required: - content - file_type - num_lines - start_line - total_lines - type title: ResponseTextEditorCodeExecutionViewResultBlock type: object ResponseTextEditorCodeExecutionCreateResultBlock: properties: is_file_update: title: 파일 업데이트 여부 type: boolean type: const: text_editor_code_execution_create_result default: text_editor_code_execution_create_result title: 유형 type: string required: - is_file_update - type title: ResponseTextEditorCodeExecutionCreateResultBlock type: object ResponseTextEditorCodeExecutionStrReplaceResultBlock: properties: lines: anyOf: - items: type: string type: array - type: 'null' default: null title: |- 마지막 프레임 이미지 URL **제약 조건:** - 마지막 프레임은 첫 프레임이 필요합니다 - 총 이미지 수가 2를 초과하면 마지막 프레임이 지원되지 않습니다 new_lines: anyOf: - type: integer - type: 'null' default: null title: 새 라인 new_start: anyOf: - type: integer - type: 'null' default: null title: |- 이미지에서 보고 싶지 않은 콘텐츠를 설명하는 네거티브 프롬프트, 출력을 제한하는 데 사용 **참고:** - 중국어와 영어를 지원하며, 최대 길이 `500`자, 각 한자/글자는 한 글자로 계산, 초과 시 자동으로 잘림 old_lines: anyOf: - type: integer - type: 'null' default: null title: 이전 라인 old_start: anyOf: - type: integer - type: 'null' default: null title: |- 객체 유형. Messages의 경우, 항상 `"message"`입니다. type: const: text_editor_code_execution_str_replace_result default: text_editor_code_execution_str_replace_result title: 유형 type: string required: - lines - new_lines - new_start - old_lines - old_start - type title: ResponseTextEditorCodeExecutionStrReplaceResultBlock type: object CacheCreation: properties: ephemeral_1h_input_tokens: default: 0 description: 1시간 캐시 항목을 생성하는 데 사용된 입력 토큰 수. minimum: 0 title: '환경 이름 (예: production, staging)' type: integer ephemeral_5m_input_tokens: default: 0 description: 5분 캐시 항목을 생성하는 데 사용된 입력 토큰 수. minimum: 0 title: 오류 코드 type: integer required: - ephemeral_1h_input_tokens - ephemeral_5m_input_tokens title: CacheCreation type: object ServerToolUsage: properties: web_fetch_requests: default: 0 description: 웹 페치 도구 요청 수. examples: - 2 minimum: 0 title: 웹 페치 요청 type: integer web_search_requests: default: 0 description: 웹 검색 도구 요청 수. examples: - 0 minimum: 0 title: 웹 검색 요청 type: integer required: - web_fetch_requests - web_search_requests title: ServerToolUsage type: object ResponseClearThinking20251015Edit: properties: cleared_input_tokens: description: |- 생성할 이미지 수, `[1,4]` 사이의 정수 값 지원 **참고:** - 단일 요청은 `n` 값을 기준으로 선불 청구되며, 실제 청구는 생성된 이미지 수를 기준으로 합니다 minimum: 0 title: Cleared Input Tokens type: integer cleared_thinking_turns: description: 제거된 사고 턴 수. minimum: 0 title: Cleared Thinking Turns type: integer type: const: clear_thinking_20251015 default: clear_thinking_20251015 description: 적용된 컨텍스트 관리 편집 유형. title: 유형 type: string required: - cleared_input_tokens - cleared_thinking_turns - type title: ResponseClearThinking20251015Edit type: object ResponseClearToolUses20250919Edit: properties: cleared_input_tokens: description: |- 생성할 이미지 수, `[1,4]` 사이의 정수 값 지원 **참고:** - 단일 요청은 `n` 값을 기준으로 선불 청구되며, 실제 청구는 생성된 이미지 수를 기준으로 합니다 minimum: 0 title: Cleared Input Tokens type: integer cleared_tool_uses: description: 제거된 도구 사용 수. minimum: 0 title: Cleared Tool Uses type: integer type: const: clear_tool_uses_20250919 default: clear_tool_uses_20250919 description: 적용된 컨텍스트 관리 편집 유형. title: 유형 type: string required: - cleared_input_tokens - cleared_tool_uses - type title: ResponseClearToolUses20250919Edit type: object Skill: description: 컨테이너에 로드된 스킬 (응답 모델). properties: skill_id: description: 스킬 ID maxLength: 64 minLength: 1 title: 스킬 Id type: string type: description: 스킬 유형 - 'anthropic' (내장) 또는 'custom' (사용자 정의) enum: - anthropic - custom title: 유형 type: string version: description: 스킬 버전 또는 최신 버전의 경우 'latest' maxLength: 64 minLength: 1 title: 버전 type: string required: - skill_id - type - version title: 스킬 type: object RequestBashCodeExecutionToolResultError: additionalProperties: false properties: error_code: $ref: '#/components/schemas/BashCodeExecutionToolResultErrorCode' type: const: bash_code_execution_tool_result_error title: 유형 type: string required: - error_code - type title: RequestBashCodeExecutionToolResultError type: object RequestBashCodeExecutionResultBlock: additionalProperties: false properties: content: items: $ref: '#/components/schemas/RequestBashCodeExecutionOutputBlock' title: 콘텐츠 type: array return_code: title: 반환 코드 type: integer stderr: title: Stderr type: string stdout: title: Stdout type: string type: const: bash_code_execution_result title: 유형 type: string required: - content - return_code - stderr - stdout - type title: RequestBashCodeExecutionResultBlock type: object RequestCodeExecutionToolResultError: additionalProperties: false properties: error_code: $ref: '#/components/schemas/CodeExecutionToolResultErrorCode' type: const: code_execution_tool_result_error title: 유형 type: string required: - error_code - type title: 코드 실행 도구 오류 type: object RequestCodeExecutionResultBlock: additionalProperties: false properties: content: items: $ref: '#/components/schemas/RequestCodeExecutionOutputBlock' title: 콘텐츠 type: array return_code: title: 반환 코드 type: integer stderr: title: Stderr type: string stdout: title: Stdout type: string type: const: code_execution_result title: 유형 type: string required: - content - return_code - stderr - stdout - type title: 코드 실행 결과 type: object Base64PDFSource: additionalProperties: false properties: data: format: byte title: 데이터 type: string media_type: const: application/pdf title: >- 웹 페이지 텍스트 콘텐츠를 컨텍스트에 포함하여 사용하는 최대 토큰 수. 이 제한은 근사치이며 PDF와 같은 바이너리 콘텐츠에는 적용되지 않습니다. type: string type: const: base64 title: 유형 type: string required: - data - media_type - type title: PDF (base64) type: object ContentBlockSource: additionalProperties: false properties: content: anyOf: - type: string - items: discriminator: mapping: image: $ref: '#/components/schemas/RequestImageBlock' text: $ref: '#/components/schemas/RequestTextBlock' propertyName: type oneOf: - $ref: '#/components/schemas/RequestTextBlock' - $ref: '#/components/schemas/RequestImageBlock' type: array title: 콘텐츠 type: const: content title: 유형 type: string required: - content - type title: 콘텐츠 블록 type: object FileDocumentSource: additionalProperties: false properties: file_id: title: File Id type: string type: const: file title: 유형 type: string required: - file_id - type title: 파일 문서 type: object PlainTextSource: additionalProperties: false properties: data: title: 데이터 type: string media_type: const: text/plain title: >- 웹 페이지 텍스트 콘텐츠를 컨텍스트에 포함하여 사용하는 최대 토큰 수. 이 제한은 근사치이며 PDF와 같은 바이너리 콘텐츠에는 적용되지 않습니다. type: string type: const: text title: 유형 type: string required: - data - media_type - type title: 일반 텍스트 type: object Base64ImageSource: additionalProperties: false properties: data: format: byte title: 데이터 type: string media_type: enum: - image/jpeg - image/png - image/gif - image/webp title: >- 웹 페이지 텍스트 콘텐츠를 컨텍스트에 포함하여 사용하는 최대 토큰 수. 이 제한은 근사치이며 PDF와 같은 바이너리 콘텐츠에는 적용되지 않습니다. type: string type: const: base64 title: 유형 type: string required: - data - media_type - type title: Base64ImageSource type: object FileImageSource: additionalProperties: false properties: file_id: title: File Id type: string type: const: file title: 유형 type: string required: - file_id - type title: FileImageSource type: object RequestTextEditorCodeExecutionToolResultError: additionalProperties: false properties: error_code: $ref: '#/components/schemas/TextEditorCodeExecutionToolResultErrorCode' error_message: anyOf: - type: string - type: 'null' title: '오류 코드 (예: invalid_api_key, insufficient_credits)' type: const: text_editor_code_execution_tool_result_error title: 유형 type: string required: - error_code - type title: RequestTextEditorCodeExecutionToolResultError type: object RequestTextEditorCodeExecutionViewResultBlock: additionalProperties: false properties: content: title: 콘텐츠 type: string file_type: enum: - text - image - pdf title: 파일 유형 type: string num_lines: anyOf: - type: integer - type: 'null' title: |- Nucleus sampling 매개변수 **참고**: - 누적 확률에서 토큰 샘플링을 제어합니다 - 예를 들어, 0.9는 상위 90% 누적 확률의 토큰에서 샘플링하는 것을 의미합니다 - 기본값: 1.0 (모든 토큰 고려) **권장사항**: temperature와 top_p를 동시에 조정하지 마세요 start_line: anyOf: - type: integer - type: 'null' title: 시작 줄 total_lines: anyOf: - type: integer - type: 'null' title: 총 줄 수 type: const: text_editor_code_execution_view_result title: 유형 type: string required: - content - file_type - type title: RequestTextEditorCodeExecutionViewResultBlock type: object RequestTextEditorCodeExecutionCreateResultBlock: additionalProperties: false properties: is_file_update: title: 파일 업데이트 여부 type: boolean type: const: text_editor_code_execution_create_result title: 유형 type: string required: - is_file_update - type title: RequestTextEditorCodeExecutionCreateResultBlock type: object RequestTextEditorCodeExecutionStrReplaceResultBlock: additionalProperties: false properties: lines: anyOf: - items: type: string type: array - type: 'null' title: |- 마지막 프레임 이미지 URL **제약 조건:** - 마지막 프레임은 첫 프레임이 필요합니다 - 총 이미지 수가 2를 초과하면 마지막 프레임이 지원되지 않습니다 new_lines: anyOf: - type: integer - type: 'null' title: 새 라인 new_start: anyOf: - type: integer - type: 'null' title: |- 이미지에서 보고 싶지 않은 콘텐츠를 설명하는 네거티브 프롬프트, 출력을 제한하는 데 사용 **참고:** - 중국어와 영어를 지원하며, 최대 길이 `500`자, 각 한자/글자는 한 글자로 계산, 초과 시 자동으로 잘림 old_lines: anyOf: - type: integer - type: 'null' title: 이전 라인 old_start: anyOf: - type: integer - type: 'null' title: |- 객체 유형. Messages의 경우, 항상 `"message"`입니다. type: const: text_editor_code_execution_str_replace_result title: 유형 type: string required: - type title: RequestTextEditorCodeExecutionStrReplaceResultBlock type: object RequestWebFetchToolResultError: additionalProperties: false properties: error_code: $ref: '#/components/schemas/WebFetchToolResultErrorCode' type: const: web_fetch_tool_result_error title: 유형 type: string required: - error_code - type title: RequestWebFetchToolResultError type: object RequestWebFetchResultBlock: additionalProperties: false properties: content: $ref: '#/components/schemas/RequestDocumentBlock' retrieved_at: anyOf: - type: string - type: 'null' description: 콘텐츠가 검색된 ISO 8601 타임스탬프 title: 검색 시간 type: const: web_fetch_result title: 유형 type: string url: description: 가져온 콘텐츠 URL title: Url type: string required: - content - type - url title: RequestWebFetchResultBlock type: object RequestWebSearchResultBlock: additionalProperties: false properties: encrypted_content: title: 종료 인덱스 type: string page_age: anyOf: - type: string - type: 'null' title: 페이지 연령 title: title: 제목 type: string type: const: web_search_result title: 유형 type: string url: title: Url type: string required: - encrypted_content - title - type - url title: RequestWebSearchResultBlock type: object RequestWebSearchToolResultError: additionalProperties: false properties: error_code: $ref: '#/components/schemas/WebSearchToolResultErrorCode' type: const: web_search_tool_result_error title: 유형 type: string required: - error_code - type title: RequestWebSearchToolResultError type: object AllThinkingTurns: additionalProperties: false properties: type: const: all title: 유형 type: string required: - type title: AllThinkingTurns type: object ThinkingTurns: additionalProperties: false properties: type: const: thinking_turns title: 유형 type: string value: minimum: 1 title: 값 type: integer required: - type - value title: ThinkingTurns type: object InputTokensClearAtLeast: additionalProperties: false properties: type: const: input_tokens title: 유형 type: string value: minimum: 0 title: 값 type: integer required: - type - value title: InputTokensClearAtLeast type: object ToolUsesKeep: additionalProperties: false properties: type: const: tool_uses title: 유형 type: string value: minimum: 0 title: 값 type: integer required: - type - value title: ToolUsesKeep type: object InputTokensTrigger: additionalProperties: false properties: type: const: input_tokens title: 유형 type: string value: minimum: 1 title: 값 type: integer required: - type - value title: InputTokensTrigger type: object ToolUsesTrigger: additionalProperties: false properties: type: const: tool_uses title: 유형 type: string value: minimum: 1 title: 값 type: integer required: - type - value title: ToolUsesTrigger type: object WebSearchToolResultErrorCode: enum: - invalid_tool_input - unavailable - max_uses_exceeded - too_many_requests - query_too_long title: WebSearchToolResultErrorCode type: string WebFetchToolResultErrorCode: enum: - invalid_tool_input - url_too_long - url_not_allowed - url_not_accessible - unsupported_content_type - too_many_requests - max_uses_exceeded - unavailable title: WebFetchToolResultErrorCode type: string ResponseDocumentBlock: properties: citations: anyOf: - $ref: '#/components/schemas/ResponseCitationsConfig' - type: 'null' default: null description: 문서에 대한 인용 설정 source: discriminator: mapping: base64: $ref: '#/components/schemas/Base64PDFSource' text: $ref: '#/components/schemas/PlainTextSource' propertyName: type oneOf: - $ref: '#/components/schemas/Base64PDFSource' - $ref: '#/components/schemas/PlainTextSource' title: 소스 title: anyOf: - type: string - type: 'null' default: null description: 문서 제목 title: 제목 type: const: document default: document title: 유형 type: string required: - citations - source - title - type title: ResponseDocumentBlock type: object CodeExecutionToolResultErrorCode: enum: - invalid_tool_input - unavailable - too_many_requests - execution_time_exceeded title: CodeExecutionToolResultErrorCode type: string ResponseCodeExecutionOutputBlock: properties: file_id: title: File Id type: string type: const: code_execution_output default: code_execution_output title: 유형 type: string required: - file_id - type title: ResponseCodeExecutionOutputBlock type: object BashCodeExecutionToolResultErrorCode: enum: - invalid_tool_input - unavailable - too_many_requests - execution_time_exceeded - output_file_too_large title: BashCodeExecutionToolResultErrorCode type: string ResponseBashCodeExecutionOutputBlock: properties: file_id: title: File Id type: string type: const: bash_code_execution_output default: bash_code_execution_output title: 유형 type: string required: - file_id - type title: ResponseBashCodeExecutionOutputBlock type: object TextEditorCodeExecutionToolResultErrorCode: enum: - invalid_tool_input - unavailable - too_many_requests - execution_time_exceeded - file_not_found title: TextEditorCodeExecutionToolResultErrorCode type: string RequestBashCodeExecutionOutputBlock: additionalProperties: false properties: file_id: title: File Id type: string type: const: bash_code_execution_output title: 유형 type: string required: - file_id - type title: RequestBashCodeExecutionOutputBlock type: object RequestCodeExecutionOutputBlock: additionalProperties: false properties: file_id: title: File Id type: string type: const: code_execution_output title: 유형 type: string required: - file_id - type title: RequestCodeExecutionOutputBlock type: object ResponseCitationsConfig: properties: enabled: default: false title: |- 워터마크 활성화 **참고:** - `true`: 생성된 비디오에 워터마크 추가 - `false`: 워터마크 없음 (기본값) type: boolean required: - enabled title: ResponseCitationsConfig type: object securitySchemes: bearerAuth: type: http scheme: bearer description: |- ##모든 API는 Bearer Token 인증이 필요합니다## **API Key 받기:** [API Key 관리 페이지](https://evolink.ai/dashboard/keys)를 방문하여 API Key를 받으세요 **요청 헤더에 추가:** ``` Authorization: Bearer YOUR_API_KEY ``` ````