> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Kimi API（全モデル）- Responses 完全リファレンス

> reasoning.effort で推論強度、prompt_cache_options でキャッシュを指定します。検索は web_search_call 出力項目で返されます。ストリーミングでは response.completed / response.incomplete / response.failed を処理してください。出力上限に達すると incomplete になります。複数ターンでは推論、ツール呼び出し、結果を含む完全な output 履歴を渡してください。

> [!NOTE]
>
> **BaseURL**: デフォルトの BaseURL は `https://direct.evolink.ai` で、テキストモデルと長時間接続をより適切にサポートします。`https://api.evolink.ai` はマルチモーダルサービスの主要エンドポイントで、テキストモデルの代替アドレスとして使用されます。


## OpenAPI

````yaml ja/api-manual/language-series/kimi/responses/responses-reference.json POST /v1/responses
openapi: 3.1.0
info:
  title: Kimi API（全モデル）- Responses 完全リファレンス
  version: 1.0.0
  description: >-
    OpenAI Responses プロトコルで Kimi テキストモデルを呼び出します。`model` で
    `kimi-k3.1-pro`、`kimi-k3.1-pro-highspeed`、`kimi-k3` を選択します。いずれもコンテキストウィンドウは
    1,048,576 tokens で、複数ターンの会話、ストリーミング、ツール呼び出し、Web 検索、構造化出力、画像入力に対応します。


    3 モデルとも推論は常に有効で、強度は `reasoning.effort` で調整します。構造化出力とキャッシュ書き込み TTL
    はモデルにより異なります。`model` の説明をご覧ください。複数ターンでは推論とツール呼び出しの履歴を完全に保持してください。
servers:
  - url: https://direct.evolink.ai
    description: 本番環境（推奨）
  - url: https://api.evolink.ai
    description: 代替 URL
security:
  - bearerAuth: []
paths:
  /v1/responses:
    post:
      tags:
        - Responses
      summary: Kimi Responses API（全モデル）
      description: >-
        reasoning.effort で推論強度、prompt_cache_options でキャッシュを指定します。検索は
        web_search_call 出力項目で返されます。ストリーミングでは response.completed /
        response.incomplete / response.failed を処理してください。出力上限に達すると incomplete
        になります。複数ターンでは推論、ツール呼び出し、結果を含む完全な output 履歴を渡してください。
      operationId: createResponseKimi
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResponsesRequest'
            examples:
              simple:
                summary: Pro の最小リクエスト
                value:
                  model: kimi-k3.1-pro
                  input: Reply with OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
              highspeed:
                summary: Highspeed の最小リクエスト
                value:
                  model: kimi-k3.1-pro-highspeed
                  input: Reply with OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
              k3:
                summary: Kimi K3 の最小リクエスト
                value:
                  model: kimi-k3
                  input: Reply with OK.
                  max_output_tokens: 1024
              streaming:
                summary: Responses SSE ストリーミング
                value:
                  model: kimi-k3.1-pro
                  input: Reply with OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
                  stream: true
              multimodal:
                summary: 画像入力
                value:
                  model: kimi-k3.1-pro
                  input:
                    - role: user
                      content:
                        - type: input_image
                          image_url: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA...
                        - type: input_text
                          text: この画像を説明してください。
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
              function_calling:
                summary: Function Call
                value:
                  model: kimi-k3.1-pro
                  input: 北京の今日の天気を調べてください。
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
                  tools:
                    - type: function
                      name: get_weather
                      description: 指定した都市の天気を取得
                      parameters:
                        type: object
                        properties:
                          city:
                            type: string
                            description: 都市名
                        required:
                          - city
              web_search:
                summary: サーバー側の Web 検索
                value:
                  model: kimi-k3.1-pro
                  input: Use web search to find the official Kimi homepage URL.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
                  tools:
                    - type: web_search
              structured_output:
                summary: 厳密な JSON Schema（K3.1 シリーズのみ）
                value:
                  model: kimi-k3.1-pro
                  input: Return a JSON object with result equal to OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
                  text:
                    format:
                      type: json_schema
                      name: result
                      strict: true
                      schema:
                        type: object
                        properties:
                          result:
                            type: string
                        required:
                          - result
                        additionalProperties: false
              cache_1h:
                summary: 1h キャッシュへの自動書き込み（K3.1 シリーズのみ）
                value:
                  model: kimi-k3.1-pro
                  input: Reply with OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
                  prompt_cache_options:
                    mode: implicit
                    ttl: 1h
      responses:
        '200':
          description: 応答を正常に作成しました
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponsesResponse'
            text/event-stream:
              schema:
                $ref: '#/components/schemas/ResponsesStreamEvent'
        '400':
          description: リクエストエラー：無効なパラメータ
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: 認証エラー：API キーが無効または未指定
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: このリソースへのアクセス権限がありません
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: レート制限超過またはクォータ不足
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: サーバーエラー
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    ResponsesRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          enum:
            - kimi-k3.1-pro
            - kimi-k3.1-pro-highspeed
            - kimi-k3
          default: kimi-k3.1-pro
          description: >-
            呼び出すモデル：


            | モデル ID | 位置付け | 推論強度 |

            |---|---|---|

            | `kimi-k3.1-pro` | 最新世代モデル（推奨） | `low` / `high` / `max`, デフォルト
            `max` |

            | `kimi-k3.1-pro-highspeed` | Pro と同じパラメータで、より高速に生成 |
            `kimi-k3.1-pro` と同じ |

            | `kimi-k3` | 前世代モデル | `max` のみ |


            3 モデルともコンテキストウィンドウは 1,048,576 tokens で、推論は常に有効です。


            構造化出力（`text.format`）とキャッシュ書き込み TTL（`prompt_cache_options`）は K3.1
            シリーズのみ対応し、`kimi-k3` は対応しません。
        input:
          description: >-
            今回のリクエストの入力。文字列は 1 つの user
            メッセージに相当します。配列では型付き項目を順に並べ、会話履歴、ツール呼び出し、ツール結果を含められます。
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ResponsesInputItem'
        instructions:
          type: string
          description: ほかの指示より前に適用されるトップレベルのシステム指示。
        stream:
          type: boolean
          default: false
          description: true の場合、SSE イベントストリームで応答を返します。
        max_output_tokens:
          type: integer
          description: 推論と最終回答を含む最大生成トークン数。デフォルトは 131072、最大は 1048576 で、残りのコンテキストにも制限されます。
          minimum: 1
          maximum: 1048576
          default: 131072
        reasoning:
          type: object
          description: 推論に関する設定。
          properties:
            effort:
              type: string
              enum:
                - low
                - high
                - max
                - medium
                - xhigh
                - minimal
                - none
              default: max
              description: >-
                推論強度。推論は常に有効です。


                - `kimi-k3.1-pro` / `kimi-k3.1-pro-highspeed`：`low` / `high` /
                `max` を推奨し、デフォルトは `max` です。汎用クライアントとの互換性のため、`medium` は
                `high`、`xhigh` は `max`、`minimal` / `none` は `low` として扱います。`none`
                でも推論は無効になりません。

                - `kimi-k3`：`max` のみ対応します（デフォルト）。


                強度を上げると通常は推論トークンとレイテンシーが増えます。推論トークンは出力に含まれます。
        text:
          type: object
          description: 出力テキストの設定。
          properties:
            format:
              type: object
              required:
                - type
                - schema
              description: >-
                JSON Schema で出力構造を制約します。 `kimi-k3.1-pro` /
                `kimi-k3.1-pro-highspeed` のみ対応し、`kimi-k3` は対応しません。`kimi-k3`
                で構造化出力が必要な場合は Chat Completions API の `response_format`
                を使用してください。
              properties:
                type:
                  type: string
                  enum:
                    - json_schema
                name:
                  type: string
                  description: Schema 名。デフォルトは `output`。
                schema:
                  type: object
                  description: 出力構造を定義する JSON Schema。
                strict:
                  type: boolean
                  description: Schema を厳密に適用するかどうか。
        tools:
          type: array
          description: モデルが呼び出せるツール。
          items:
            $ref: '#/components/schemas/ResponsesTool'
        tool_choice:
          $ref: '#/components/schemas/ResponsesToolChoice'
        include:
          type: array
          items:
            type: string
            enum:
              - web_search_call.results
              - web_search_call.action.sources
          description: >-
            追加で返すフィールド。`web_search` 使用時のみ有効です。`web_search_call.action.sources`
            は検索元の Web ページ、`web_search_call.results` は画像検索結果を返します。
        prompt_cache_options:
          type: object
          description: >-
            コンテキストキャッシュの書き込み設定。`kimi-k3.1-pro` / `kimi-k3.1-pro-highspeed`
            のみ対応し、`kimi-k3` はこのパラメータに対応しません。省略時はデフォルトで 5m
            キャッシュへ自動書き込みされます。書き込みと読み取りは別々に課金されます。
          properties:
            mode:
              type: string
              enum:
                - implicit
              default: implicit
            ttl:
              type: string
              enum:
                - 5m
                - 1h
              default: 5m
              description: キャッシュ有効期間。5m または 1h。デフォルトは 5m。
        temperature:
          type: number
          default: 1
          description: >-
            サンプリング温度。モデル側で `1` に固定されているため、指定は不要です。`kimi-k3.1-pro` /
            `kimi-k3.1-pro-highspeed` はこのフィールドを自動的に無視し、`kimi-k3`
            は未対応の値に対してエラーを返します。
        top_p:
          type: number
          default: 0.95
          description: >-
            核サンプリングの閾値。モデル側で `0.95` に固定されているため、指定は不要です。`kimi-k3.1-pro` /
            `kimi-k3.1-pro-highspeed` はこのフィールドを自動的に無視し、`kimi-k3`
            は未対応の値に対してエラーを返します。
    ResponsesResponse:
      type: object
      description: モデルの 1 回の応答。
      properties:
        id:
          type: string
          description: 応答の一意な識別子。
          example: resp_68f0c1c2d3e4f5a6b7c8d9e0
        object:
          type: string
          enum:
            - response
        created_at:
          type: integer
          description: 応答作成時の Unix タイムスタンプ。
        completed_at:
          type:
            - integer
            - 'null'
          description: >-
            応答終了時の Unix タイムスタンプ。`status` が `completed` または `incomplete`
            で設定され、`in_progress` または `failed` では `null` です。
        status:
          type: string
          enum:
            - in_progress
            - completed
            - incomplete
            - failed
          description: 応答の状態。ストリーミングの初期スナップショットは `in_progress` です。
        model:
          type: string
          description: 今回の応答を生成したモデル。
        output:
          type: array
          description: 出力項目の配列。web_search_call（存在する場合）、reasoning、message、ツール呼び出しの順に並びます。
          items:
            $ref: '#/components/schemas/ResponsesOutputItem'
        usage:
          oneOf:
            - $ref: '#/components/schemas/ResponsesUsage'
            - type: 'null'
        incomplete_details:
          type:
            - object
            - 'null'
          description: '`status` が `incomplete` の場合の理由。'
          properties:
            reason:
              type: string
              enum:
                - max_output_tokens
                - content_filter
        error:
          type:
            - object
            - 'null'
          description: '`status` が `failed` の場合のエラー情報。'
          properties:
            code:
              type: string
            message:
              type: string
        instructions:
          type:
            - string
            - 'null'
        reasoning:
          type:
            - object
            - 'null'
        text:
          type:
            - object
            - 'null'
        tools:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/ResponsesTool'
        tool_choice:
          oneOf:
            - $ref: '#/components/schemas/ResponsesToolChoice'
            - type: 'null'
        max_output_tokens:
          type:
            - integer
            - 'null'
        temperature:
          type:
            - number
            - 'null'
        top_p:
          type:
            - number
            - 'null'
        parallel_tool_calls:
          type: boolean
        service_tier:
          type:
            - string
            - 'null'
        store:
          type: boolean
          description: '`false` 固定。'
        background:
          type:
            - boolean
            - 'null'
          description: '`false` 固定。'
        previous_response_id:
          type:
            - string
            - 'null'
          description: '`null` 固定。'
        conversation:
          type:
            - object
            - 'null'
          description: '`null` 固定。'
        prompt_cache_options:
          type: object
          description: >-
            サーバーが実際に適用したコンテキストキャッシュの書き込み設定。prompt_cache_options を省略した場合は、ここで返される
            mode と ttl に従ってください。
          properties:
            mode:
              type: string
              enum:
                - implicit
              description: 実際に適用された書き込みモード。
            ttl:
              type: string
              enum:
                - 5m
                - 1h
              description: 実際に適用されたキャッシュ有効期間。
    ResponsesStreamEvent:
      type: object
      description: >-
        `stream: true` のときの単一 SSE イベント。フレームは `event: <type>` と `data: <json>`
        で構成され、ほかのフィールドは `type` によって変わります。
      required:
        - type
        - sequence_number
      properties:
        type:
          type: string
          enum:
            - response.created
            - response.in_progress
            - response.output_item.added
            - response.output_item.done
            - response.content_part.added
            - response.content_part.done
            - response.output_text.delta
            - response.output_text.done
            - response.reasoning_summary_part.added
            - response.reasoning_summary_part.done
            - response.reasoning_summary_text.delta
            - response.reasoning_summary_text.done
            - response.function_call_arguments.delta
            - response.function_call_arguments.done
            - response.custom_tool_call_input.delta
            - response.custom_tool_call_input.done
            - response.web_search_call.in_progress
            - response.web_search_call.searching
            - response.web_search_call.completed
            - response.completed
            - response.incomplete
            - response.failed
            - error
        sequence_number:
          type: integer
          description: 0 から単調増加するイベント連番。
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: エラー原因を説明するメッセージ。
            type:
              type: string
              description: エラータイプ
            code:
              type: string
              description: エラーコード
          required:
            - message
      required:
        - error
    ResponsesInputItem:
      description: input 配列の要素。`type` で区別し、省略時は `message` として扱います。
      oneOf:
        - $ref: '#/components/schemas/ResponsesMessageItem'
        - $ref: '#/components/schemas/ResponsesReasoningItem'
        - $ref: '#/components/schemas/ResponsesFunctionCallItem'
        - $ref: '#/components/schemas/ResponsesFunctionCallOutputItem'
        - $ref: '#/components/schemas/ResponsesCustomToolCallItem'
        - $ref: '#/components/schemas/ResponsesCustomToolCallOutputItem'
        - $ref: '#/components/schemas/ResponsesWebSearchCallItem'
        - $ref: '#/components/schemas/ResponsesAdditionalToolsItem'
    ResponsesTool:
      description: >-
        `type` で区別するツール定義。`function`、`custom`（`apply_patch`
        のみ）、`namespace`、`web_search` に対応します。ほかの種類は非対応です。
      oneOf:
        - $ref: '#/components/schemas/ResponsesFunctionTool'
        - $ref: '#/components/schemas/ResponsesCustomTool'
        - $ref: '#/components/schemas/ResponsesNamespaceTool'
        - $ref: '#/components/schemas/ResponsesWebSearchTool'
      discriminator:
        propertyName: type
        mapping:
          function: '#/components/schemas/ResponsesFunctionTool'
          custom: '#/components/schemas/ResponsesCustomTool'
          namespace: '#/components/schemas/ResponsesNamespaceTool'
          web_search: '#/components/schemas/ResponsesWebSearchTool'
    ResponsesToolChoice:
      type: string
      enum:
        - auto
      description: ツール呼び出しを制御します。`auto` ではモデルが呼び出しの要否を判断します。
    ResponsesOutputItem:
      description: '`type` で区別する output 配列の要素。'
      oneOf:
        - $ref: '#/components/schemas/ResponsesOutputReasoningItem'
        - $ref: '#/components/schemas/ResponsesOutputMessageItem'
        - $ref: '#/components/schemas/ResponsesOutputFunctionCallItem'
        - $ref: '#/components/schemas/ResponsesOutputCustomToolCallItem'
        - $ref: '#/components/schemas/ResponsesOutputWebSearchCallItem'
      discriminator:
        propertyName: type
        mapping:
          reasoning: '#/components/schemas/ResponsesOutputReasoningItem'
          message: '#/components/schemas/ResponsesOutputMessageItem'
          function_call: '#/components/schemas/ResponsesOutputFunctionCallItem'
          custom_tool_call: '#/components/schemas/ResponsesOutputCustomToolCallItem'
          web_search_call: '#/components/schemas/ResponsesOutputWebSearchCallItem'
    ResponsesUsage:
      type: object
      description: >-
        input_tokens はキャッシュの読み書きを含みます。K3.1 シリーズの通常入力は cached_tokens と
        cache_write_tokens を差し引き、`kimi-k3` では cached_tokens
        のみを差し引きます。output_tokens には推論が含まれます。
      properties:
        input_tokens:
          type: integer
          description: キャッシュヒット分を含む入力トークン数。
        input_tokens_details:
          type: object
          properties:
            cached_tokens:
              type: integer
              description: コンテキストキャッシュから読み取ったトークン数。
            cache_write_tokens:
              type: integer
              description: コンテキストキャッシュに書き込んだトークン数。
        output_tokens:
          type: integer
          description: 推論トークンを含む出力トークン数。
        output_tokens_details:
          type: object
          properties:
            reasoning_tokens:
              type: integer
              description: 推論に使用したトークン数。
        total_tokens:
          type: integer
          description: 総トークン数。
    ResponsesMessageItem:
      type: object
      title: メッセージ
      description: 会話メッセージ。`type` は省略可能です。
      required:
        - role
        - content
      properties:
        type:
          type: string
          enum:
            - message
        role:
          type: string
          enum:
            - user
            - assistant
            - developer
          description: メッセージの役割。`developer` はシステム指示として扱います。
        content:
          description: 文字列またはコンテンツ項目配列のメッセージ内容。
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ResponsesInputContentPart'
        status:
          type: string
          enum:
            - completed
    ResponsesReasoningItem:
      type: object
      title: 推論
      description: 前のターンの推論内容を再送します。`content` は `summary` より優先されます。
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - reasoning
        id:
          type: string
        summary:
          type: array
          items:
            type: object
            required:
              - type
              - text
            properties:
              type:
                type: string
                enum:
                  - summary_text
              text:
                type: string
        content:
          type: array
          items:
            type: object
            required:
              - type
              - text
            properties:
              type:
                type: string
                enum:
                  - reasoning_text
              text:
                type: string
        status:
          type: string
          enum:
            - completed
    ResponsesFunctionCallItem:
      type: object
      title: Function Call
      description: 関数呼び出しを再送します。
      required:
        - type
        - call_id
        - name
        - arguments
      properties:
        type:
          type: string
          enum:
            - function_call
        id:
          type: string
        call_id:
          type: string
          description: 対応する `function_call_output` と組になる呼び出し ID。
        name:
          type: string
        namespace:
          type: string
          description: ツールの名前空間。名前空間内のツールを呼び出した場合に返されます。
        arguments:
          type: string
          description: JSON 文字列形式の関数引数。
        status:
          type: string
          enum:
            - completed
    ResponsesFunctionCallOutputItem:
      type: object
      title: 関数呼び出し結果
      description: 関数呼び出しの実行結果。
      required:
        - type
        - call_id
        - output
      properties:
        type:
          type: string
          enum:
            - function_call_output
        call_id:
          type: string
          description: 対応する `function_call` と同じ呼び出し ID。
        output:
          description: ツールが返した内容。
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ResponsesInputContentPart'
        status:
          type: string
          enum:
            - completed
    ResponsesCustomToolCallItem:
      type: object
      title: カスタムツール呼び出し
      description: カスタムツール呼び出しを再送します。
      required:
        - type
        - call_id
        - name
        - input
      properties:
        type:
          type: string
          enum:
            - custom_tool_call
        id:
          type: string
        call_id:
          type: string
          description: 対応する `custom_tool_call_output` と組になる呼び出し ID。
        name:
          type: string
        namespace:
          type: string
          description: ツールの名前空間。名前空間内のツールを呼び出した場合に返されます。
        input:
          type: string
          description: モデルが生成した自由形式のテキスト入力。
        status:
          type: string
          enum:
            - completed
    ResponsesCustomToolCallOutputItem:
      type: object
      title: カスタムツール呼び出し結果
      description: カスタムツール呼び出しの実行結果。
      required:
        - type
        - call_id
        - output
      properties:
        type:
          type: string
          enum:
            - custom_tool_call_output
        call_id:
          type: string
          description: 対応する `custom_tool_call` と同じ呼び出し ID。
        output:
          description: ツールが返した内容。
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ResponsesInputContentPart'
        status:
          type: string
          enum:
            - completed
    ResponsesWebSearchCallItem:
      type: object
      title: Web 検索呼び出し
      description: 前のターンの Web 検索記録。完全な会話履歴と一緒に渡してください。
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - web_search_call
        id:
          type: string
        status:
          type: string
          enum:
            - completed
        action:
          type: object
          properties:
            type:
              type: string
              enum:
                - search
            query:
              type: string
    ResponsesAdditionalToolsItem:
      type: object
      title: 動的ツール
      description: 会話の途中で呼び出し可能なツールを追加します。この項目の位置から有効になります。
      required:
        - type
        - role
        - tools
      properties:
        type:
          type: string
          enum:
            - additional_tools
        id:
          type: string
        role:
          type: string
          enum:
            - developer
        tools:
          type: array
          items:
            $ref: '#/components/schemas/ResponsesTool'
    ResponsesFunctionTool:
      type: object
      title: 関数ツール
      description: JSON Schema で引数を定義する関数ツール。
      required:
        - type
        - name
      properties:
        type:
          type: string
          enum:
            - function
        name:
          type: string
          description: 関数名。正規表現 ^[a-zA-Z_][a-zA-Z0-9-_]{0,127}$ に一致する必要があります。
          pattern: ^[a-zA-Z_][a-zA-Z0-9-_]{0,127}$
        description:
          type: string
        parameters:
          type: object
          description: 関数引数を定義する JSON Schema。
        strict:
          type: boolean
    ResponsesCustomTool:
      type: object
      title: カスタムツール
      description: >-
        自由形式のテキスト入力を受け取るカスタムツール。現在は `apply_patch` のみ対応し、`grammar` + `lark`
        の形式定義が必須です。呼び出しは output に `custom_tool_call` として返されます。
      required:
        - type
        - name
        - format
      properties:
        type:
          type: string
          enum:
            - custom
        name:
          type: string
          enum:
            - apply_patch
          description: ツール名。現在は `apply_patch` のみ対応。
        description:
          type: string
        format:
          type: object
          description: 入力形式の制約。`grammar` 型と `lark` 構文のみ対応します。
          required:
            - type
            - syntax
            - definition
          properties:
            type:
              type: string
              enum:
                - grammar
            syntax:
              type: string
              enum:
                - lark
            definition:
              type: string
              description: Lark 構文定義。
    ResponsesNamespaceTool:
      type: object
      title: 名前空間ツール
      description: 関数ツールやカスタムツールのグループを同じ名前空間にまとめます。
      required:
        - type
        - name
        - description
        - tools
      properties:
        type:
          type: string
          enum:
            - namespace
        name:
          type: string
        description:
          type: string
        tools:
          type: array
          items:
            oneOf:
              - $ref: '#/components/schemas/ResponsesFunctionTool'
              - $ref: '#/components/schemas/ResponsesCustomTool'
    ResponsesWebSearchTool:
      type: object
      title: Web 検索ツール
      description: >-
        モデルがネット上の情報を必要とするときに呼び出す Web 検索ツール。検索記録は web_search_call で返されます。1
        リクエストにつき最大 1 個指定できます。
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - web_search
        filters:
          type: object
          description: 検索範囲のフィルター。
          properties:
            allowed_domains:
              type: array
              items:
                type: string
              maxItems: 100
              description: 指定したドメイン内のみ検索します。最大 100 個。
        search_content_types:
          type: array
          items:
            type: string
            enum:
              - text
              - image
          default:
            - text
          description: 検索結果の種類。デフォルトは `text` のみ。`image` を含めると画像検索も実行します。
        image_settings:
          type: object
          description: 画像検索の設定。`search_content_types` に `image` を含む場合のみ有効です。
          properties:
            max_results:
              type: integer
              minimum: 1
              maximum: 10
              default: 3
              description: 返される画像の最大数。
            caption:
              type: boolean
              default: false
              description: 画像の説明文を生成するかどうか。
    ResponsesOutputReasoningItem:
      type: object
      title: 推論
      description: モデルの推論内容。
      properties:
        type:
          type: string
          enum:
            - reasoning
        id:
          type: string
          example: rs_68f0c1c2d3e4f5a6b7c8d9e0
        summary:
          type: array
          description: 推論内容。
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                  - summary_text
              text:
                type: string
        encrypted_content:
          type:
            - string
            - 'null'
          description: '`null` 固定。'
        status:
          type: string
          enum:
            - in_progress
            - completed
    ResponsesOutputMessageItem:
      type: object
      title: メッセージ
      description: モデルのテキスト回答。
      properties:
        type:
          type: string
          enum:
            - message
        id:
          type: string
          example: msg_68f0c1c2d3e4f5a6b7c8d9e0
        role:
          type: string
          enum:
            - assistant
        content:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                  - output_text
              text:
                type: string
              annotations:
                type: array
                items: {}
        status:
          type: string
          enum:
            - in_progress
            - completed
    ResponsesOutputFunctionCallItem:
      type: object
      title: Function Call
      description: モデルが要求した関数呼び出し。
      properties:
        type:
          type: string
          enum:
            - function_call
        id:
          type: string
          example: fc_68f0c1c2d3e4f5a6b7c8d9e0
        call_id:
          type: string
          description: 結果を返す際、`function_call_output` でこの値を使用します。
        name:
          type: string
        namespace:
          type: string
          description: 名前空間内のツールを呼び出すと返されます。
        arguments:
          type: string
          description: JSON 文字列形式の関数引数。
        status:
          type: string
          enum:
            - in_progress
            - completed
    ResponsesOutputCustomToolCallItem:
      type: object
      title: カスタムツール呼び出し
      description: モデルが要求したカスタムツール呼び出し。
      properties:
        type:
          type: string
          enum:
            - custom_tool_call
        id:
          type: string
          example: ctc_68f0c1c2d3e4f5a6b7c8d9e0
        call_id:
          type: string
          description: 結果を返す際、`custom_tool_call_output` でこの値を使用します。
        name:
          type: string
        namespace:
          type: string
          description: 名前空間内のツールを呼び出すと返されます。
        input:
          type: string
          description: モデルが生成した自由形式のテキスト入力。
        status:
          type: string
          enum:
            - in_progress
            - completed
    ResponsesOutputWebSearchCallItem:
      type: object
      title: Web 検索呼び出し
      description: >-
        サーバー側の Web 検索呼び出し。リクエストに `web_search` があり、サーバーが検索を必要と判断した場合のみ、output
        配列の先頭に返されます。
      properties:
        type:
          type: string
          enum:
            - web_search_call
        id:
          type: string
          example: ws_68f0c1c2d3e4f5a6b7c8d9e0
        status:
          type: string
          enum:
            - in_progress
            - completed
        action:
          type: object
          description: 今回の検索で実行した操作。
          properties:
            type:
              type: string
              enum:
                - search
            query:
              type: string
              description: 実際に使用した検索キーワード。
            sources:
              type: array
              description: >-
                検索にヒットした Web ページの出典。`include` に `web_search_call.action.sources`
                を含む場合のみ返されます。
              items:
                type: object
                properties:
                  type:
                    type: string
                    enum:
                      - url
                  url:
                    type: string
                  title:
                    type: string
        results:
          type: array
          description: >-
            画像検索結果。`include` に `web_search_call.results`、`search_content_types`
            に `image` を含む場合のみ返されます。
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                  - image_result
              image_url:
                type: string
              thumbnail_url:
                type: string
              source_website_url:
                type: string
              caption:
                type: string
                description: 画像の説明文。`image_settings.caption` が有効な場合のみ返されます。
    ResponsesInputContentPart:
      description: '`type` で区別する content 配列の要素。'
      oneOf:
        - type: object
          title: 入力テキスト
          required:
            - type
            - text
          properties:
            type:
              type: string
              enum:
                - input_text
            text:
              type: string
        - type: object
          title: 入力画像
          required:
            - type
            - image_url
          properties:
            type:
              type: string
              enum:
                - input_image
            image_url:
              type: string
              description: >-
                画像の data URL（例：`data:image/png;base64,<base64>`）。公開 http(s) URL
                には対応しません。
            detail:
              type: string
              enum:
                - auto
                - low
                - high
                - original
        - type: object
          title: 出力テキスト
          description: assistant のテキスト履歴を再送する場合に使用します。
          required:
            - type
            - text
          properties:
            type:
              type: string
              enum:
                - output_text
            text:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: |-
        ##すべての API で Bearer Token 認証が必要です##

        **API キーの取得：**

        [API キー管理ページ](https://evolink.ai/dashboard/keys)で API キーを取得してください

        **リクエストヘッダーに追加：**
        ```
        Authorization: Bearer YOUR_API_KEY
        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.