API | GPT 6.1 Terra API — Vision, rédaction, 1M

openai/gpt-6.1-terra/chat

GPT 6.1 Terra lit captures d’écran et documents pour en tirer des brouillons ciblés ou des champs structurés. Terra prévoit 4,096 tokens de réponse par défaut et jusqu’à 128,000 ; au-dessus de none, le raisonnement utilise lui aussi cette enveloppe.

Entrée $1Sortie $5par 1 million de tokensEntrée en cache $0.05Écriture en cache $1.25Prompts de plus de 272K tokensEntrée $2Entrée en cache $0.10Écriture en cache $2.50Sortie $7.50

Exécuter le modèle Voir l’API

Envoyer une requête

Les exemples suivent les paramètres publics du point de terminaison choisi. Remplacez la clé API et les médias d’exemple, puis envoyez la requête depuis votre serveur.

SDK et intégrations

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

Authentification API

Conservez la clé API dans la variable serveur SPICY_API_KEY. Utilisez l’authentification Bearer et Content-Type: application/json pour les requêtes 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'

Généré à partir du schéma d’entrée de ce modèle, le même que l’API utilise pour valider chaque requête.

Conservez le même Idempotency-Key pour chaque requête logique. Après une coupure réseau, ne renvoyez pas automatiquement la requête avec une nouvelle clé. Gardez request_id pour retrouver la requête acceptée. Le flux de chat précédent n’est pas rejoué.

Paramètres d’entrée

Placez les paramètres du modèle au même niveau que model dans le corps JSON. Ce point de terminaison ne les encapsule pas dans un objet input.

messagesarray<object>Obligatoire

Transmettez à Terra la capture et les consignes d’extraction dans messages, en gardant les identifiants d’appels lors des échanges suivants.

Valeur par défaut: Non définie
Contraintes: minItems:1
maxItems:256

messages[].rolestringObligatoire dans l’objet

Role of the message author.

Valeur par défaut: Non définie
Valeurs autorisées: "system""developer""user""assistant""tool"

messages[].namestringFacultatif

Optional name identifying the speaker within its role.

Valeur par défaut: Non définie

messages[].contentstring | array | nullFacultatif

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

Valeur par défaut: Non définie

{
  "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>Facultatif

Tool calls the assistant requested in this message.

Valeur par défaut: Non définie

messages[].tool_call_idstringFacultatif

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

Valeur par défaut: Non définie

messages[].reasoning_contentstringFacultatif

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

Valeur par défaut: Non définie

{
  "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_formatobjectFacultatif

Demandez une structure JSON pour les champs extraits par Terra, puis contrôlez-la avec votre schéma.

Valeur par défaut: Non définie

tool_choicestring | objectFacultatif

Choisissez auto, none, required ou une fonction nommée pour le traitement documentaire de Terra.

Valeur par défaut: Non définie

parallel_tool_callsbooleanFacultatif

Permettez à Terra plusieurs recherches indépendantes ensemble si aucun résultat n’est nécessaire pour formuler un autre appel.

Valeur par défaut: true

toolsarray<object>Facultatif

Décrivez les fonctions de recherche ou d’extraction proposées à Terra ; leur exécution revient à votre application.

Valeur par défaut: Non définie
Contraintes: maxItems:128

top_pnumberFacultatif

Pour Terra avec reasoning_effort none, top_p resserre le choix des tokens ; ajustez-le indépendamment de temperature.

Valeur par défaut: Non définie
Contraintes: minimum:0.01
maximum:1

temperaturenumberFacultatif

Avec Terra, temperature s’applique à reasoning_effort none pour régler la diversité des petits brouillons.

Valeur par défaut: Non définie
Contraintes: minimum:0
maximum:2

stopstring | arrayFacultatif

Terra accepte une séquence d’arrêt ou une liste de quatre au plus ; évitez un marqueur présent dans les valeurs extraites.

Valeur par défaut: Non définie
Contraintes: minLength:1
minItems:1
maxItems:4

reasoning_effortstringFacultatif

Terra accepte none, low, medium, high, xhigh et max ; none convient à une extraction directe.

Valeur par défaut: "medium"
Valeurs autorisées: "none""low""medium""high""xhigh""max"

max_tokensintegerFacultatif

Dimensionnez max_tokens de Terra pour le brouillon et le raisonnement ; valeur initiale 4,096, maximum 128,000.

Valeur par défaut: 4096
Contraintes: 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
}

Lire le résultat

Avec stream à false, la requête renvoie directement la réponse complète : lisez choices[].message, sans interroger de tâche. Passez stream à true si votre client gère les Server-Sent Events.

Exemple de réponse terminée

{
  "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
  }
}

Cette réponse n’illustre que la structure. usage donne le nombre de tokens ; la consommation et le coût réels dépendent de votre requête.

SDK et intégrations

Utilisez SpicyAPI dans votre application, terminal, assistant IA ou workflow visuel. Choisissez un guide de configuration.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Commandes de terminal et scripts d’automatisation.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instructions réutilisables pour votre assistant IA.

n8n

Nœuds communautaires pour n8n auto-hébergé et workflows HTTP Request à importer dans n8n Cloud.

ComfyUI

Workflows image, vidéo et audio sur un canevas de nœuds.

Autres intégrations

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

Parcourir les workflows prêts à utiliser

C’est un modèle de conversation : il fonctionne partout où fonctionne l’API chat d’OpenAI. Gardez votre client, changez l’URL de base, désignez ce modèle par son identifiant.

Pointez ici n’importe quel client compatible 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

Tout outil compatible avec l’API chat d’OpenAI s’utilise de la même façon — les SDK, le Vercel AI SDK, LangChain, aider, Cline. Le serveur MCP et la CLI spicyapi prennent en charge les tâches média asynchrones. Retrouvez la configuration de chaque outil dans l’espace développeurs.

L’utiliser dans SillyTavern et les applis de jeu de rôle

Dans SillyTavern, RisuAI, Agnai ou toute appli dotée d’un réglage compatible OpenAI, collez l’URL de base ci-dessous et votre clé d’API, puis choisissez openai/gpt-6.1-terra/chat comme modèle. Les appels depuis le navigateur sont acceptés, et les curseurs que ce modèle ne prend pas en charge sont ignorés au lieu d’être refusés.

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

Guide SillyTavern RisuAI, Agnai et d’autres Extension SillyTavern

À utiliser dans ComfyUI

Installez les nœuds SpicyAPI depuis ComfyUI Manager ou avec la commande ci-dessous, puis choisissez openai/gpt-6.1-terra/chat dans le nœud SpicyAPI Chat pour utiliser ce modèle dans un graphe ComfyUI.

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

Exemples de workflows Guide d’installation Code source sur GitHub

Le panneau intégré lit le même schéma que cette page : il ne peut donc pas diverger de l’API. Si votre documentation a besoin d’un contenu indexable, récupérez plutôt le JSON sous /api/embed/models/ et affichez-le vous-même.

<iframe src="https://spicyapi.ai/embed/fr/models/gpt-6-1-terra/api?model=openai%2Fgpt-6.1-terra%2Fchat" width="100%" height="560" loading="lazy" title="Exemple de requête" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Ouvrir le panneau

Atelier

Envoyer une requête

Authentification API

Paramètres d’entrée

Lire le résultat

SDK et intégrations

L’utiliser dans SillyTavern et les applis de jeu de rôle

À utiliser dans ComfyUI