# GPT 4o Mini Search Preview

Model id on AIHubMix: `gpt-4o-mini-search-preview`
Create an API key: https://console.aihubmix.com/?utm_source=llms-agent&utm_medium=model-llms

> Using the Chat Completions API, you can directly access the fine-tuned models and tool used by Search in ChatGPT.

When using Chat Completions, the model always retrieves information from the web before responding to your query. To use web_search_preview as a tool that models like gpt-4o and gpt-4o-mini invoke only when necessary, switch to using the Responses API.

Currently, you need to use one of these models to use web search in Chat Completions:

gpt-4o-search-preview
gpt-4o-mini-search-preview
Web search parameter example
import OpenAI from "openai";
const client = new OpenAI();

const completion = await client.chat.completions.create({
    model: "gpt-4o-search-preview",
    web_search_options: {},
    messages: [{
        "role": "user",
        "content": "What was a positive news story from today?"
    }],
});

console.log(completion.choices[0].message.content);
Output and citations
The API response item in the choices array will include:

message.content with the text result from the model, inclusive of any inline citations
annotations with a list of cited URLs
By default, the model's response will include inline citations for URLs found in the web search results. In addition to this, the url_citation annotation object will contain the URL and title of the cited source, as well as the start and end index characters in the model's response where those sources were used.

> Capability flags (tool use, structured output, vision, reasoning, …) are **not published** for this model. AIHubMix lists them only after official confirmation and this id is not covered yet — their absence below means unverified, not unsupported. Everything else here comes from the live catalog. Verify with a minimal real call before relying on a capability (see https://aihubmix.com/agents.md — an HTTP 200 alone is not success).

- Developer: OpenAI
- Context window: 128,000 tokens
- Input modalities: text, image
- Pricing: $0.15/M input tokens, $0.6/M output tokens, $0.075/M cached input

## Endpoints (base URL: https://aihubmix.com)

- `POST /v1/chat/completions` — OpenAI Chat Completions (`Authorization: Bearer $AIHUBMIX_API_KEY`)

## Example

```bash
curl -s https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini-search-preview","messages":[{"role":"user","content":"Hello"}]}'
```

## Response

Without `stream`, `/v1/chat/completions` returns a standard Chat Completions object:

```json
{"id":"...","object":"chat.completion","model":"gpt-4o-mini-search-preview","choices":[{"message":{"role":"assistant","content":"..."}}],"usage":{"prompt_tokens":12,"completion_tokens":24,"total_tokens":36}}
```

With `"stream": true` the response is `text/event-stream`: read each `data:` JSON chunk until `data: [DONE]`. The Messages and Gemini endpoints return their protocols' native response shapes (Anthropic / Google).

## Errors

Error responses carry a `tid` (trace id) — include it when contacting support. Reference: https://docs.aihubmix.com/en/FAQs/HTTP-Codes.md

- 400 — parameter error; most are passed through from the upstream provider (media: `prompt_missing`, `size_not_supported`, `n_not_within_range`, …)
- 401 — missing `Authorization` header, or the key is invalid/expired
- 403 — `insufficient_user_quota` (top up at https://console.aihubmix.com/?utm_source=llms-agent&utm_medium=model-llms), account suspended, or this key is not allowed to use this model
- 429 — rate limited; back off and retry
- 503 — no channel can serve the request (check the model id and your access), or the upstream provider is throttling; retry later

## More

- Model page: https://aihubmix.com/model/gpt-4o-mini-search-preview
- Try in browser: https://playground.aihubmix.com/?model=gpt-4o-mini-search-preview
- Compare with another model (human-facing, side-by-side specs and pricing): https://aihubmix.com/compare — pick this model and a peer there; published pairs are listed in https://aihubmix.com/sitemap-compare.xml, unpublished pairs 404 so do not compose the path by hand
- Full parameter schema: follow `https://aihubmix.com/model-data/index.json` — find this id and fetch its `path` (filenames are content-addressed; do not compose them by hand)
- Generate runnable code programmatically: npm `@aihubmix/codegen` — the generator behind the Playground's "Get Code" (4 protocols × 7 languages, media endpoints included); the body it builds is the exact wire body the Playground sends, so generated snippets and real requests cannot diverge. `@aihubmix/model-schema` (npm) translates the parameter schema above into codegen input
- Site index for agents: https://aihubmix.com/llms.txt · Onboarding: https://aihubmix.com/agents.md

---

Canonical version of this document: https://aihubmix.com/model/gpt-4o-mini-search-preview/llms.txt