GPT-5.6 Terra

GPT-5.6 Terra is the balanced model in OpenAI's GPT-5.6 series, positioned between the flagship Sol tier and the cost-efficient Luna tier. OpenAI GPT-5.6 Balanced Tier, with a 1M token context window.

POST/v1/ai/chat

$0.01/call

Overview

Property	Value
Model ID	`openai/gpt-5.6-terra`
Context Window	1,050,000 tokens
Max Output	128,000 tokens
Input Price	$2.95 / 1M tokens
Output Price	$17.72 / 1M tokens

Usage

const res = await fetch('https://api.yepapi.com/v1/ai/chat', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/gpt-5.6-terra',
    messages: [{ role: 'user', content: 'Explain the difference between optimistic and pessimistic locking, with a short example of each in SQL.' }],
  }),
});
const { data } = await res.json();
console.log(data.message.content);

curl -X POST https://api.yepapi.com/v1/ai/chat \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-5.6-terra", "messages": [{"role": "user", "content": "Explain the difference between optimistic and pessimistic locking, with a short example of each in SQL."}]}'

Request Body

Parameter	Type	Required	Description	Default
`model`	`string`	Yes	Model ID (e.g. `openai/gpt-5.6-terra`)	—
`messages`	`Message[]`	Yes	Array of `{ role, content }` objects	—
`maxTokens`	`number`	No	Maximum tokens in the response	Model default
`temperature`	`number`	No	Sampling temperature (0.0–2.0)	`1.0`
`topP`	`number`	No	Nucleus sampling threshold	`1.0`
`frequencyPenalty`	`number`	No	Penalize repeated tokens	`0`
`presencePenalty`	`number`	No	Penalize tokens already present	`0`
`stream`	`boolean`	No	Enable SSE streaming	`false`

Info

All AI models use the /v1/ai/chat endpoint. Specify the model with the model field.

Response

{
  "ok": true,
  "data": {
    "model": "openai/gpt-5.6-terra",
    "message": {
      "role": "assistant",
      "content": "Pessimistic locking takes the lock up front (SELECT ... FOR UPDATE) so nobody else can change the row while you work. Optimistic locking reads a version column, does the work, and updates WHERE version = the one you read; if zero rows change, someone else won and you retry. Use pessimistic for short, contended transactions and optimistic when conflicts are rare."
    },
    "usage": {
      "promptTokens": 16,
      "completionTokens": 245,
      "totalTokens": 261
    }
  }
}

Streaming

Set "stream": true to receive Server-Sent Events. Each chunk contains a delta object:

data: {"delta":{"content":"Use"},"model":"openai/gpt-5.6-terra","index":0}
data: [DONE]

Under the Hood

We handle auth, billing, and response normalization — you just send messages.