Skip to main content

openai/gpt-6.1-terra/chat

GPT 6.1 Terra reads screenshots and documents, then turns the supplied evidence into concise drafts or extracted fields. Terra defaults to a 4,096-token reply cap and permits 128,000; reserve part of that allowance for reasoning whenever effort is above none.

Input $1Output $5per 1 million tokensCached input $0.05Cache write $1.25Prompts over 272K tokensInput $2Cached input $0.10Cache write $2.50Output $7.50
Run model

Workbench

Send a request

Quickstart

Examples use the selected endpoint’s public parameter definitions. Replace the API key and example media, then send the request from your server.

SDKs & integrations
POSThttps://api.spicyapi.ai/v1/chat/completions

API authentication

Keep the API key in the server environment variable SPICY_API_KEY. Use Bearer authentication and Content-Type: application/json for JSON requests.

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'

Generated from this model’s input schema — the same one the API validates every request against.

Keep one Idempotency-Key for each logical request. After a network interruption, do not automatically resend with a new key; retain request_id to investigate the accepted request. Idempotency does not replay an earlier chat stream.

Input parameters

Place the model parameters directly in the JSON request body alongside model. This endpoint does not use an input wrapper.

messagesarray<object>Required

Send Terra the screenshot with the extraction instructions in messages and preserve tool-call IDs on follow-up turns.

Default
Not specified
Constraints
minItems:1
maxItems:256
response_formatobjectOptional

Request the JSON shape for Terra’s extracted fields and check it against your schema.

Default
Not specified
tool_choicestring | objectOptional

Choose auto, none, required or a named function for Terra’s document workflow.

Default
Not specified
parallel_tool_callsbooleanOptional

Allow Terra to propose several independent lookups together when no result is needed to form another call.

Default
true
toolsarray<object>Optional

Describe the lookup or extraction functions Terra can propose; execution belongs to your application.

Default
Not specified
Constraints
maxItems:128
top_pnumberOptional

For Terra at reasoning_effort none, top_p narrows the sampling pool; change it independently of temperature.

Default
Not specified
Constraints
minimum:0.01
maximum:1
temperaturenumberOptional

Terra’s temperature applies with reasoning_effort none; use it to tune variation in short drafts.

Default
Not specified
Constraints
minimum:0
maximum:2
stopstring | arrayOptional

Terra accepts one stop string or a list of up to four; avoid a marker likely to appear inside an extracted value.

Default
Not specified
Constraints
minLength:1
minItems:1
maxItems:4
reasoning_effortstringOptional

Terra accepts none, low, medium, high, xhigh and max; none is useful for a direct extraction task.

Default
"medium"
Allowed values
"none""low""medium""high""xhigh""max"
max_tokensintegerOptional

Set Terra’s max_tokens for the requested draft and any reasoning; 4,096 is the default and 128,000 the upper limit.

Default
4096
Constraints
minimum:1
maximum:128000

Read the result

With stream set to false, the request returns the completed chat response directly. Read choices[].message; no task polling is needed. Set stream to true when your client supports Server-Sent Events.

Completed response example
{
  "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
  }
}

The response example is illustrative. usage reports token counts; token counts and charges depend on your actual request.

SDKs & integrations

Use SpicyAPI in your app, terminal, AI assistant or visual workflow. Choose a setup guide below.

SDKs
TypeScript · Python · Go · PHP · Java
CLI
Terminal commands and automation scripts.
MCP
Claude Code · Cursor · Codex
Agent Skill
Reusable instructions for your AI assistant.
n8n
Self-hosted community nodes and importable HTTP Request templates for n8n Cloud.
ComfyUI
Image, video and audio workflows on a node canvas.

More integrations

SillyTavernTelegram / DiscordApp proxyOpenAI SDKLangChainVercel AI SDK
Browse ready-to-use workflows

Use it in SillyTavern and roleplay apps

In SillyTavern, RisuAI, Agnai or any app with an OpenAI-compatible setting, paste the base URL below and your API key, then pick openai/gpt-6.1-terra/chat as the model. Browser calls are allowed, and sliders this model does not take are ignored instead of rejected.

Base URL: https://api.spicyapi.ai/v1
Model: openai/gpt-6.1-terra/chat
SillyTavern guideRisuAI, Agnai and moreSillyTavern extension

Use it in ComfyUI

Install the SpicyAPI nodes from ComfyUI Manager or with the command below, then pick openai/gpt-6.1-terra/chat in the SpicyAPI Chat node to use this model inside a ComfyUI graph.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi
Workflow examplesSetup guideSource on GitHub