# GPT-6 Astra - Core.Today AI API

> OpenAI's most capable model (GPT-6 generation, September 2026), built for the hardest end-to-end work: complex reasoning, coding, computer use, research and document creation. 1M token context window, 128K max output tokens, cached inputs at a 90% discount. Prompts above 272K input tokens are billed at 2x input / 1.5x output for the whole request.

- **Provider**: OpenAI
- **Model ID**: gpt-6-astra
- **Category**: LLM
- **Credits**: 5 per request
- **Speed**: Fast
- **Quality**: Ultra

## Model Specifications
- **Context Window**: 1M tokens
- **Max Output**: 128K tokens
- **Training Cutoff**: 2026-04
- **Supported Formats**: text, json, markdown
- **Compatible SDK**: OpenAI

### Capabilities
- Vision (image input)
- Function Calling
- Streaming
- JSON Mode
- System Prompt

### Token Pricing (per 1M tokens)
- **Input Tokens**: 18,580 credits ($12.39)
- **Output Tokens**: 92,900 credits ($61.93)
- **Cached Tokens**: 1,858 credits ($1.24)

## Features
- Most capable OpenAI model (GPT-6 generation)
- 1M token context window
- 128K max output tokens
- Knowledge cutoff: April 2026
- Cached input pricing (90% discount)
- Adjustable reasoning effort (low to max)
- Function calling and native vision support

## Use Cases
- Frontier reasoning and analysis
- Complex agentic workflows with tool use
- Large-codebase understanding and refactoring
- Long document processing up to 1M tokens
- Repeated context with cached inputs (RAG, codebases)

## API Endpoint

Base URL: https://api.core.today
Endpoint: POST /llm/openai/v1/chat/completions

## Authentication
Header: Authorization: Bearer YOUR_API_KEY

Note: LLM endpoints use OpenAI-compatible format with Authorization Bearer token.

## Input Parameters

### Required
- **messages**: array - Array of message objects with role and content
- **model**: string (default: gpt-6-astra) - Model identifier

### Optional
- **max_completion_tokens**: integer (default: 4096) - Maximum tokens in response (up to 128000). Note: use max_completion_tokens, not max_tokens
- **reasoning_effort**: string (default: medium) - Reasoning effort level: low, medium, high, xhigh, or max
  Options: low, medium, high, xhigh, max
- **temperature**: float (default: 1.0) - Sampling temperature (0-2)
- **stream**: boolean (default: false) - Enable Server-Sent Events streaming

## Examples

### Frontier Agentic Coding
Multi-step code reasoning with GPT-6 Astra
```json
{
  "model": "gpt-6-astra",
  "messages": [
    {
      "role": "system",
      "content": "You are a senior software engineer. Think step by step."
    },
    {
      "role": "user",
      "content": "Design a migration plan from a monolithic Express API to modular services, then generate the first service's code with tests."
    }
  ],
  "reasoning_effort": "high",
  "max_completion_tokens": 8000
}
```

### Cached Repeated Context
Reuse a large system prompt with 90% cached input discount
```json
{
  "model": "gpt-6-astra",
  "messages": [
    {
      "role": "system",
      "content": "<large repeated system prompt or codebase context>"
    },
    {
      "role": "user",
      "content": "Summarize the open TODOs and rank them by risk."
    }
  ],
  "temperature": 0.3,
  "max_completion_tokens": 4000
}
```

## Response Format
```json
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Response text here"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 100,
    "completion_tokens": 50,
    "total_tokens": 150
  }
}
```

## Tips
- Astra is the top of the line ($10/$50 per M) — use GPT-5.6 Sol ($5/$30) or Terra ($2/$12) when tasks don't need maximum capability
- Use cached inputs ($1/M, 90% off) for repeated system prompts and RAG context
- Keep prompts under 272K input tokens where possible — above that the whole request bills at 2x input / 1.5x output
- reasoning_effort 'high', 'xhigh' or 'max' for the most complex tasks
- 128K output enables single-shot long-form generation
- Lower temperature (0.2-0.5) for coding and analytical tasks

## Documentation
https://platform.openai.com/docs/models