Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

nexos.ai Chat API

Generate a response from conversation messages.

nexos.ai Chat API is one of 16 APIs that nexos.ai publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Chat. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 1 operation across 1 path, and defines 42 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against a single base URL, https://api.nexos.ai.

1 operations 1 paths 42 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://api.nexos.ai
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

nexos.ai Chat API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). An API key is passed in the header as X-Api-Key (apiKeyHeader). By default, every request must be authenticated.

  • apiKeyHeader — Authenticate by sending your nexos API key in the X-Api-Key header (e.g. X-Api-Key: nexos-... for a user key or X-Api-Key: nexos-team-... for a team key). This…

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Chat 1

Generate a response from conversation messages.

POST
/v1/chat/completions
Create chat completion
post-chat-completions-v1 1 param body → 200400402500

Schemas 42

The contract defines 42 schemas that model the data the API accepts and returns. The most detailed are ChatCompletionsRequest (31 properties), chat_completions_messages_ChatCompletionRequestAssistantMessage (7 properties), RagMCP (5 properties), UserLocation (5 properties). Each schema is shown below with its type and property counts.

chat_completions_messages_ChatCompletionRequestAssistantMessage
object
Messages sent by the model in response to user messages.
7 properties 1 required
UserLocation
object
5 properties 1 required
chat_completions_messages_ChatCompletionRequestToolMessageContentPart
ChatCompletionModalities
array
Output types that you would like the model to generate for this request. Most models are capable of generating text, which is the default: ["text"] To request…
ChatCompletionToolChoiceOption
Controls which (if any) tool is called by the model. none means the model will not call any tool and instead generates a message. auto means the model can pick…
URLSearch
object
4 properties 2 required
chat_completions_messages_ChatCompletionRequestUserMessage
object
Messages sent by an end user, containing prompts or additional context information.
3 properties 2 required
ResponseFormatJsonSchemaSchema
object
The schema for the response format, described as a JSON Schema object.
ChatCompletionWebSearch
object
The web search that the model called.
3 properties
ChatCompletionsRequest
object
31 properties 2 required
ChatCompletionTool
object
5 properties 1 required
chat_completions_messages_ChatCompletionMessageToolCall
object
3 properties 3 required
ChatCompletionRequestMessageContentPartText
object
2 properties 2 required
chat_completions_messages_ChatCompletionRequestSystemMessageContentPart
ParallelToolCalls
boolean
Whether to enable parallel function calling during tool use.
ChatCompletionFunctionCallOption
object
Specifying a particular function via {"name": "myfunction"} forces the model to call that function.
1 property 1 required
chat_completions_messages_ChatCompletionRequestMessage
FunctionObject
object
4 properties 1 required
WebSearchMCP
object
Custom MCP websearch
2 properties 2 required
chat_completions_messages_ChatCompletionMessageToolCalls
array
The tool calls generated by the model, such as function calls.
chat_completions_messages_ChatCompletionRequestToolMessage
object
3 properties 3 required
ResponseFormatText
object
1 property 1 required
PredictionContent
object
Static predicted output content, such as the content of a text file that is being regenerated.
2 properties 2 required
chat_completions_messages_ChatCompletionRequestUserMessageContentPart
ResponseFormatJsonSchema
object
2 properties 2 required
ChatCompletionNamedToolChoice
object
Specifies a tool the model should use. Use to force the model to call a specific function.
2 properties 2 required
ResponseFormatJsonObject
object
1 property 1 required
ChatCompletionTikaOCR
object
Tika OCR that the model called.
1 property 1 required
chat_completions_messages_ChatCompletionRequestSystemMessage
object
Developer-provided instructions that the model should follow, regardless of messages sent by the user. With o1 models and newer, use developer messages for thi…
3 properties 2 required
chat_completions_messages_ChatCompletionRequestMessageContentPartAudio
object
Learn about [audio inputs](/docs/guides/audio).
2 properties 2 required
RagMCP
object
RAG MCP tool call
5 properties 1 required
chat_completions_messages_ChatCompletionRequestMessageContentPartImage
object
Learn about [image inputs](/docs/guides/vision).
2 properties 2 required
chat_completions_messages_ChatCompletionRequestMessageContentPartRefusal
object
2 properties 2 required
ChatCompletionRAG
object
RAG tool call
1 property
chat_completions_messages_ChatCompletionRequestMessageContentPartText
object
Learn about [text inputs](/docs/guides/text-generation).
2 properties 2 required
chat_completions_messages_ChatCompletionRequestAssistantMessageContentPart
FunctionParameters
object
The parameters the functions accepts, described as a JSON Schema object. Omitting parameters defines a function with an empty parameter list.
chat_completions_messages_ChatCompletionRequestFunctionMessage
object
3 properties 3 required
QuerySearch
object
4 properties 2 required
ChatCompletionStreamOptions
object
Options for streaming response. Only set this when you set stream: true.
1 property
ChatCompletionFunctions
object
3 properties 1 required
ChatCompletionRequestDeveloperMessage
object
Developer-provided instructions that the model should follow, regardless of messages sent by the user. With o1 models and newer, developer messages replace the…
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nexosai-chat-api-openapi.yml Raw ↑

Other APIs nexos.ai publishes across the network.

nexos.ai Agent Management API
nexos.ai Assistant Management API
nexos.ai Audio API
nexos.ai Batches API
nexos.ai Budget Limit Management API
nexos.ai Company Management API
nexos.ai Embeddings API
nexos.ai Files API
nexos.ai Images API
nexos.ai Messages API
nexos.ai Models API
nexos.ai Responses API