# openai/gpt-5.4-mini

> GPT-5.4 mini brings the core capabilities of GPT-5.4 into a faster, more efficient model designed for high-throughput workloads. It delivers strong performance in reasoning, coding, and tool use, while significantly reducing latency and operational costs.Purpose-built for production environments, the model achieves a powerful balance between performance and efficiency. It is ideal for chat applications, coding assistants, and large-scale agent workflows, providing reliable instruction following, effective multi-step reasoning, and consistent results across diverse tasks with improved cost efficiency.

## Overview

- **Endpoint**: `https://api.shortapi.ai/v1/chat/completions`
- **Model ID**: `openai/gpt-5.4-mini`
- **Category**: llm
- **Kind**: text-generation

## Pricing

$0.075/M tokens input (cache hit) · $0.750/M tokens input (cache miss) · $4.500/M tokens output

For more details, please check our pricing page.

## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.

### Input Schema

The API accepts the following input parameters (standard OpenAI format):

- **`model`** (`string`, _required_):
  Model ID

- **`messages`** (`array<object>`, _required_):
  List of conversation messages

  - **`role`** (`string`, _required_):
    Message Role
    - Options: "system", "user", "assistant", "tool", "developer"

  - **`content`** (`string | array<object>`, _required_):
    Message content

    - **`type`** (`string`, _optional_):
      - Options: "text", "image_url", "input_audio", "file", "video_url"

    - **`text`** (`string`, _optional_):

    - **`image_url`** (`object`, _optional_):

      - **`url`** (`string`, _required_):
        Image URL or base64

      - **`detail`** (`string`, _optional_):
        - Options: "auto", "low", "high"

    - **`input_audio`** (`object`, _optional_):

      - **`data`** (`string`, _optional_):
        Base64 encoded audio data

      - **`format`** (`string`, _optional_):
        - Options: "wav", "mp3"

    - **`file`** (`object`, _optional_):

      - **`file_id`** (`string`, _required_):
        File ID

      - **`filename`** (`string`, _optional_):

      - **`file_data`** (`string`, _optional_):

    - **`video_url`** (`object`, _optional_):

      - **`url`** (`string`, _optional_):

  - **`name`** (`string`, _optional_):
    Sender's Name

  - **`tool_calls`** (`array<object>`, _optional_):

    - **`id`** (`string`, _required_):

    - **`type`** (`string`, _required_):

    - **`function`** (`object`, _optional_):

      - **`name`** (`string`, _optional_):

      - **`arguments`** (`string`, _optional_):

  - **`tool_call_id`** (`string`, _optional_):
    Tool invocation ID (used for messages of the tool role)

  - **`reasoning_content`** (`string`, _optional_):
    Reasoning content

- **`temperature`** (`number`, _optional_):
  Sampling temperature
  - Default: `1`
  - Range: `0` to `2`

- **`top_p`** (`number`, _optional_):
  Nuclear sampling parameters
  - Default: `1`
  - Range: `0` to `1`

- **`stream`** (`boolean`, _optional_):
  Is it a streaming response?
  - Default: `false`

- **`stream_options`** (`object`, _optional_):

  - **`include_usage`** (`boolean`, _optional_):

- **`stop`** (`string | array<string>`, _optional_):
  Stop sequence

- **`max_tokens`** (`integer`, _optional_):
  Maximum number of generated tokens

- **`max_completion_tokens`** (`integer`, _optional_):
  Maximum number of completed tokens

- **`presence_penalty`** (`number`, _optional_):
  - Default: `0`
  - Range: `-2` to `2`

- **`frequency_penalty`** (`number`, _optional_):
  - Default: `0`
  - Range: `-2` to `2`

- **`logit_bias`** (`object`, _optional_):

- **`user`** (`string`, _optional_):

- **`tools`** (`array<object>`, _optional_):

  - **`type`** (`string`, _required_):

  - **`function`** (`object`, _required_):
    The function definition

    - **`name`** (`string`, _required_):

    - **`description`** (`string`, _optional_):

    - **`parameters`** (`object`, _optional_):
      Parameter definitions in JSON Schema format

- **`tool_choice`** (`string | object`, _optional_):

  - **`type`** (`string`, _optional_):

  - **`function`** (`object`, _optional_):
    The function definition

    - **`name`** (`string`, _optional_):

- **`response_format`** (`object`, _optional_):

  - **`type`** (`string`, _optional_):
    - Options: "text", "json_object", "json_schema"

  - **`schema`** (`object`, _optional_):
    JSON Schema definition

- **`seed`** (`integer`, _optional_):

- **`reasoning_effort`** (`string`, _optional_):
  Inference strength (the model used to support the inference)
  - Options: "low", "medium", "high"

- **`modalities`** (`array<string>`, _optional_):

- **`audio`** (`object`, _optional_):

  - **`format`** (`string`, _optional_):

  - **`voice`** (`string`, _optional_):

### Output Schema

The API returns a standard OpenAI JSON response.

```json
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1677858242,
  "model": "gpt-4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 25,
    "total_tokens": 35,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 10,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 25,
      "audio_tokens": 0,
      "reasoning_tokens": 0
    }
  },
  "system_fingerprint": "fp_44709d6fcb"
}
```

## Use Example

### Bash (cURL)
```bash
curl --request POST \
  --url https://api.shortapi.ai/v1/chat/completions \
  --header "Authorization: Bearer $SHORTAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "openai/gpt-5.4-mini",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "Hello, how are you?"
    }
  ],
  "temperature": 0.7,
  "max_tokens": 128000
}'
```

### JavaScript (Fetch API)
```javascript
const response = await fetch(`https://api.shortapi.ai/v1/chat/completions`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${SHORTAPI_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "openai/gpt-5.4-mini",
    messages: [
      { role: "system", content: "You are a helpful assistant." },
      { role: "user", content: "Hello, how are you?" }
    ],
    temperature: 0.7,
    max_tokens: 128000
  })
});
const data = await response.json();
```

### Python (Requests)
```python
import requests

url = "https://api.shortapi.ai/v1/chat/completions"
payload = {
    "model": "openai/gpt-5.4-mini",
    "messages": [
        { "role": "system", "content": "You are a helpful assistant." },
        { "role": "user", "content": "Hello, how are you?" }
    ],
    "temperature": 0.7,
    "max_tokens": 128000
}
headers = {
    "Authorization": f"Bearer {SHORTAPI_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()
```