API | GPT 6.1 Terra API — 画像・文章作成・ 1M

openai/gpt-6.1-terra/chat

GPT 6.1 Terra はスクリーンショットや文書を読み取り、その内容から目的に合う下書きや構造化された項目を作成します。Terra の回答上限は既定で 4,096 トークン、最大 128,000 です。none より上の推論設定では、推論もこの枠を使います。

入力 $1出力 $5100 万トークンあたりキャッシュ入力 $0.05キャッシュ書き込み $1.25272K トークンを超えるプロンプト入力 $2キャッシュ入力 $0.10キャッシュ書き込み $2.50出力 $7.50

モデルを実行 API を見る

リクエストを送信

例は、選択中のエンドポイントの公開パラメーター定義から作っています。API キーとサンプル素材を差し替えて、ご自身のサーバーから送信してください。

SDK・連携

POSThttps://api.spicyapi.ai/v1/chat/completions

API 認証

API キーはサーバーの環境変数 SPICY_API_KEY に保存します。Bearer 認証を使用し、JSON リクエストには Content-Type: application/json を指定してください。

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "openai/gpt-6.1-terra/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

このモデルの入力スキーマから生成した例です。API はどのリクエストも、同じスキーマで検証します。

同じ論理リクエストには同じ Idempotency-Key を使い続けてください。通信が切れた場合は新しいキーで自動再送せず、受理済みリクエストを追跡できるよう request_id を保存します。冪等性は、過去のチャットストリームを再生するものではありません。

入力パラメーター

モデルのパラメーターは、JSON リクエスト本文の model と同じ階層に指定します。このエンドポイントでは input でラップしません。

messagesarray<object>必須

Terra の messages に画面と抽出指示を渡し、継続時はツール呼び出しの ID を保持してください。

デフォルト値: 指定なし
制約: minItems:1
maxItems:256

messages[].rolestringオブジェクト内で必須

Role of the message author.

デフォルト値: 指定なし
使用可能な値: "system""developer""user""assistant""tool"

messages[].namestring任意

Optional name identifying the speaker within its role.

デフォルト値: 指定なし

messages[].contentstring | array | null任意

Message content, either plain text or a list of content parts.

デフォルト値: 指定なし

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "const": "image_url"
          },
          "image_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>任意

Tool calls the assistant requested in this message.

デフォルト値: 指定なし

messages[].tool_call_idstring任意

Identifier of the tool call this message answers. Required on tool messages.

デフォルト値: 指定なし

messages[].reasoning_contentstring任意

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

デフォルト値: 指定なし

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "image_url"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                },
                "image_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "maxItems": 256,
  "minItems": 1,
  "description": "Conversation history in order, oldest message first."
}

response_formatobject任意

Terra の抽出項目を JSON 形式で要求し、想定したスキーマと照合してください。

デフォルト値: 指定なし

tool_choicestring | object任意

Terra の文書処理では auto、none、required、または指定した関数を選びます。

デフォルト値: 指定なし

parallel_tool_callsboolean任意

別の呼び出しに結果を使わない Terra の検索は、同じターンで複数提案できるようにします。

デフォルト値: true

toolsarray<object>任意

Terra が提案できる検索・抽出関数を定義します。実際の実行はアプリが担当します。

デフォルト値: 指定なし
制約: maxItems:128

top_pnumber任意

Terra の reasoning_effort none では top_p で候補を絞れます。temperature とは別々に調整してください。

デフォルト値: 指定なし
制約: minimum:0.01
maximum:1

temperaturenumber任意

Terra の temperature は reasoning_effort none で適用され、短い下書きの変化を調整します。

デフォルト値: 指定なし
制約: minimum:0
maximum:2

stopstring | array任意

Terra の停止文字列は 1 件または最大 4 件です。抽出値に含まれる文字列は避けてください。

デフォルト値: 指定なし
制約: minLength:1
minItems:1
maxItems:4

reasoning_effortstring任意

Terra は none、low、medium、high、xhigh、max に対応します。単純な抽出では none を試せます。

デフォルト値: "medium"
使用可能な値: "none""low""medium""high""xhigh""max"

max_tokensinteger任意

Terra の下書きと推論を考慮して max_tokens を設定します。既定は 4,096、最大は 128,000 です。

デフォルト値: 4096
制約: minimum:1
maximum:128000

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "maxLength": 32,
        "minLength": 1
      },
      "maxItems": 4,
      "minItems": 1,
      "minLength": 1,
      "description": "Sequences that end the reply as soon as the model writes one; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "top_p": {
      "type": "number",
      "x-ui": {
        "step": 0.01,
        "order": 40,
        "widget": "slider"
      },
      "maximum": 1,
      "minimum": 0.01,
      "description": "Nucleus sampling threshold. Lower values keep only the most likely tokens."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "image_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "image_url"
                    },
                    "image_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 256,
      "minItems": 1,
      "description": "Conversation history in order, oldest message first."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 80,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 4096,
      "maximum": 128000,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "temperature": {
      "type": "number",
      "x-ui": {
        "order": 50,
        "widget": "slider"
      },
      "maximum": 2,
      "minimum": 0,
      "description": "Sampling temperature. Higher values make the output more varied."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "none",
        "low",
        "medium",
        "high",
        "xhigh",
        "max"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "medium",
      "description": "How much reasoning the model spends before answering."
    },
    "parallel_tool_calls": {
      "type": "boolean",
      "x-ui": {
        "order": 33,
        "widget": "switch",
        "affects_price": false
      },
      "default": true,
      "description": "Whether the model may request more than one tool call in a single turn."
    }
  },
  "x-image-token-limit": 37000,
  "x-input-token-limit": 1050000,
  "additionalProperties": false,
  "x-max-tokens-includes-reasoning": true
}

結果を取得

stream が false の場合、完成したチャット応答が直接返ります。choices[].message を読み取ってください。タスクのポーリングは不要です。Server-Sent Events 対応のクライアントでは stream を true にできます。

完了レスポンスの例

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "openai/gpt-6.1-terra/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

レスポンス例は構造を示すためのものです。usage はトークン数を示し、実際のトークン数と料金はリクエスト内容によって変わります。

SDK・連携

アプリ、ターミナル、AI アシスタント、ビジュアルワークフローで SpicyAPI を活用。接続ガイドを選んでください。

SDKs

TypeScript · Python · Go · PHP · Java

CLI

ターミナルコマンドと自動化スクリプト。

MCP

Claude Code · Cursor · Codex

Agent Skill

AI アシスタントで再利用できる手順。

n8n

セルフホスト版のコミュニティノードと、n8n Cloud にインポートできる HTTP Request テンプレート。

ComfyUI

ノードで組み立てる画像・動画・音声ワークフロー。

その他の連携

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

すぐ使えるワークフローを見る

これはチャットモデルなので、OpenAI のチャット API が通る場所ならどこでも動きます。クライアントはそのまま、ベース URL を差し替えて、このモデル ID を指定してください。

OpenAI 互換クライアントの向き先を変えるだけ

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/openai/gpt-6.1-terra/chat

OpenAI のチャット API に対応するツールは同じ方法で使えます。SDK、Vercel AI SDK、LangChain、aider、Cline などに対応します。MCP サーバーと spicyapi CLI は非同期のメディアタスクに対応します。ツールごとの設定は開発者ハブをご覧ください。

SillyTavern やロールプレイアプリで使う

SillyTavern、RisuAI、Agnai など OpenAI 互換の設定があるアプリに、下のベース URL と API キーを貼り付け、モデルに openai/gpt-6.1-terra/chat を選んでください。ブラウザーからの呼び出しにも対応しており、このモデルが受け付けないスライダーはエラーにならず無視されます。

Base URL: https://api.spicyapi.ai/v1
Model: openai/gpt-6.1-terra/chat

SillyTavern ガイド RisuAI・Agnai ほか SillyTavern 拡張機能

ComfyUI で使う

ComfyUI Manager か下のコマンドで SpicyAPI ノードをインストールしたら、SpicyAPI Chat ノードで openai/gpt-6.1-terra/chat を選ぶと、ComfyUI のグラフの中でこのモデルを使えます。

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

ワークフロー例セットアップガイド GitHub のソース

埋め込みパネルはこのページと同じスキーマを参照するため、API 仕様とのずれを防げます。ドキュメント内の検索対象にする場合は、/api/embed/models/ の JSON を取得して描画してください。

<iframe src="https://spicyapi.ai/embed/ja/models/gpt-6-1-terra/api?model=openai%2Fgpt-6.1-terra%2Fchat" width="100%" height="560" loading="lazy" title="リクエスト例" style="border:1px solid rgba(0,0,0,.12)"></iframe>

パネルを開く

プレイグラウンド

リクエストを送信

API 認証

入力パラメーター

結果を取得

SDK・連携

SillyTavern やロールプレイアプリで使う

ComfyUI で使う