The identity and technical contract details declared by the specification.
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
CompletionUsage
object
Usage statistics for the completion request. Fields: - completiontokens (required): int - prompttokens (required): int - totaltokens (required): int - completi…
5 properties
3 required
ChatCompletionRequestUserMessage
object
Messages sent by an end user, containing prompts or additional context information. Fields: - content (required): str | Annotated[list[ChatCompletionRequestUse…
3 properties
2 required
ChatCompletionRequestMessageContentPartRefusal
object
Schema for ChatCompletionRequestMessageContentPartRefusal. Fields: - type (required): Literal["refusal"] - refusal (required): str
2 properties
2 required
Credential
object
Credential for MCP server authentication. Passed at endpoint level (e.g., chat.completions.create) and matched to MCP servers by connection name. Wire format m…
2 properties
2 required
ChatCompletionResponseMessage
object
A chat completion message generated by the model. Fields: - content (required): str | None - refusal (required): str | None - toolcalls (optional): ChatComplet…
7 properties
3 required
ChatCompletionRequestMessageContentPartText
object
Learn about [text inputs](/docs/guides/text-generation). Fields: - type (required): Literal["text"] - text (required): str
2 properties
2 required
FunctionCall
object
Deprecated and replaced by toolcalls. The name and arguments of a function that should be called, as generated by the model. Fields: - arguments (required): st…
2 properties
2 required
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
MCPCredentials
array
List of credentials for MCP server authentication.
ChatCompletionStreamResponseDelta
object
A chat completion delta generated by streamed model responses. Fields: - content (optional): str | None - functioncall (optional): ChatCompletionStreamResponse…
5 properties
ChatCompletionMessageCustomToolCall
object
A call to a custom tool created by the model. Fields: - id (required): str - type (required): Literal["custom"] - custom (required): ChatCompletionMessageCusto…
3 properties
3 required
VoiceIdsOrCustomVoiceInline
object
Custom voice reference. Fields: - id (required): str
1 property
1 required
DedalusModel
object
Structured model selection entry used in request payloads. Supports OpenAI-style semantics (string model id) while enabling optional per-model default settings…
2 properties
1 required
ChatCompletionTokenLogprob
object
Token log probability information.
4 properties
4 required
ChatCompletionStreamResponseChoicesItemLogprobs
object
Log probability information for the choice. Fields: - content (required): list[ChatCompletionTokenLogprob] - refusal (required): list[ChatCompletionTokenLogpro…
2 properties
2 required
PredictionContent
object
Static predicted output content, such as the content of a text file that is being regenerated. Fields: - type (required): Literal["content"] - content (require…
2 properties
2 required
ChatCompletionStreamResponseChoicesItem
object
Schema for ChatCompletionStreamResponseChoicesItem. Fields: - delta (required): ChatCompletionStreamResponseDelta - logprobs (optional): ChatCompletionStreamRe…
4 properties
3 required
ThinkingConfigDisabled
object
Schema for ThinkingConfigDisabled. Fields: - type (required): Literal["disabled"]
1 property
1 required
PendingCallResponse
object
Client-side tool call the SDK must execute.
4 properties
3 required
DedalusModelChoice
Dedalus model choice - either a string ID or DedalusModel configuration object.
ResponseFormatJsonSchemaSchema
object
The schema for the response format, described as a JSON Schema object. Learn how to build JSON schemas [here](https://json-schema.org/).
MCPServerSpec
object
Structured MCP server specification. Slug-based: {"slug": "dedalus-labs/brave-search", "name": "github-integration", "version": "v1.0.0"} URL-based: {"url": "h…
5 properties
1 required
SafetySetting
object
Per-category safety setting that pairs a content category with a blocking threshold. Fields: - category (required): SafetyCategory - threshold (required): Safe…
2 properties
2 required
JSONSchema
object
Structured Outputs configuration options, including a JSON Schema. Fields: - description (optional): str - name (required): str - schema (optional): ResponseFo…
4 properties
1 required
Audio
object
Data about a previous audio response from the model. [Learn more](/docs/guides/audio). Fields: - id (required): str
1 property
1 required
ModelId
string
Model identifier string (e.g., 'openai/gpt-5', 'anthropic/claude-3-5-sonnet').
ThinkingConfigAdaptive
object
Schema for ThinkingConfigAdaptive. Fields: - type (required): Literal["adaptive"]
1 property
1 required
ChatCompletion
object
Chat completion response for Dedalus API. OpenAI-compatible chat completion response with Dedalus extensions. Maintains full compatibility with OpenAI API whil…
16 properties
5 required
MCPServerError
object
Error details for a single MCP server failure.
3 properties
1 required
ChatCompletionRequestFunctionMessage
object
Schema for ChatCompletionRequestFunctionMessage. Fields: - role (required): Literal["function"] - content (required): str | None - name (required): str
3 properties
3 required
ChatCompletionRequest
object
ChatCompletion request schema. Supports OpenAI-compatible parameters, provider-specific extensions, server-side execution, and agent orchestration features.
61 properties
1 required
ResponseFormatText
object
Default response format. Used to generate text responses. Fields: - type (required): Literal["text"]
1 property
1 required
DeferredCallResponse
object
Server-side call blocked until pending client calls complete. Carries full spec for stateless resumption on subsequent turns.
6 properties
2 required
ChatCompletionRequestMessageContentPartFile
object
Learn about [file inputs](/docs/guides/text) for text generation. Fields: - type (required): Literal["file"] - file (required): File
2 properties
2 required
ThinkingConfigEnabled
object
Schema for ThinkingConfigEnabled. Fields: - budgettokens (required): int - type (required): Literal["enabled"]
2 properties
2 required
ChatCompletionFunctions
object
Schema for ChatCompletionFunctions. Fields: - description (optional): str - name (required): str - parameters (optional): FunctionParameters
3 properties
1 required
ModelSettings
object
51 properties
ChatCompletionRequestAudio
object
Parameters for audio output. Required when audio output is requested with modalities: ["audio"]. [Learn more](/docs/guides/audio). Fields: - voice (required):…
2 properties
2 required
ResponseFormatJsonObject
object
JSON object response format. An older method of generating JSON responses. Using jsonschema is recommended for models that support it. Note that the model will…
1 property
1 required
Reasoning
object
gpt-5 and o-series models only Configuration options for [reasoning models](https://platform.openai.com/docs/guides/reasoning).
3 properties
Choice
object
A chat completion choice. OpenAI-compatible choice object for non-streaming responses. Part of the ChatCompletion response.
4 properties
2 required
ChatCompletionRequestMessageContentPartImage
object
Learn about [image inputs](/docs/guides/vision). Fields: - type (required): Literal["imageurl"] - imageurl (required): ImageUrl
2 properties
2 required
ChatCompletionRequestToolMessage
object
Schema for ChatCompletionRequestToolMessage. Fields: - role (required): Literal["tool"] - content (required): str | Annotated[list[ChatCompletionRequestToolMes…
3 properties
3 required
ChatCompletionRequestMessageContentPartAudio
object
Learn about [audio inputs](/docs/guides/audio). Fields: - type (required): Literal["inputaudio"] - inputaudio (required): InputAudio
2 properties
2 required
FunctionParameters
object
The parameters the functions accepts, described as a JSON Schema object. See the [guide](/docs/guides/function-calling) for examples, and the [JSON Schema refe…
ChatCompletionStreamResponse
object
Represents a streamed chunk of a chat completion response returned by the model, based on the provided input. [Learn more](/docs/guides/streaming-responses). F…
8 properties
5 required
ToolChoiceAny
object
The model will use any available tools. Fields: - disableparalleltooluse (optional): bool - type (required): Literal["any"]
2 properties
1 required
MCPToolResult
object
Result of a single MCP tool execution. Provides visibility into MCP tool calls including the full input arguments and structured output, enabling debugging and…
6 properties
4 required
CompletionTokensDetails
object
Breakdown of tokens used in a completion. Fields: - acceptedpredictiontokens (optional): int - audiotokens (optional): int - reasoningtokens (optional): int -…
4 properties
CacheControlEphemeral
object
Schema for CacheControlEphemeral. Fields: - ttl (optional): Literal["5m", "1h"] - type (required): Literal["ephemeral"]
2 properties
1 required
PromptTokensDetails
object
Breakdown of tokens used in the prompt. Fields: - audiotokens (optional): int - cachedtokens (optional): int
2 properties
ValidationError
object
5 properties
3 required
ToolChoiceTool
object
The model will use the specified tool with toolchoice.name. Fields: - disableparalleltooluse (optional): bool - name (required): str - type (required): Literal…
3 properties
2 required
ChatCompletionRequestAssistantMessage
object
Messages sent by the model in response to user messages. Fields: - content (optional): str | Annotated[list[ChatCompletionRequestAssistantMessageContentPart],…
7 properties
1 required
HTTPValidationError
object
1 property
ToolChoiceNone
object
The model will not be allowed to use tools. Fields: - type (required): Literal["none"]
1 property
1 required
ToolChoiceAuto
object
The model will automatically decide whether to use tools. Fields: - disableparalleltooluse (optional): bool - type (required): Literal["auto"]
2 properties
1 required
MCPToolChoice
object
2 properties
2 required
ChatCompletionMessageToolCall
object
A call to a function tool created by the model. Fields: - id (required): str - type (required): Literal["function"] - function (required): ChatCompletionMessag…
4 properties
3 required
ResponseFormatJsonSchema
object
JSON Schema response format. Used to generate structured JSON responses. Learn more about [Structured Outputs](/docs/guides/structured-outputs). Fields: - type…
2 properties
2 required
Tool
object
Schema for Tool. Fields: - type (optional): ToolTypes - function (required): Function
2 properties
1 required
Function
object
Schema for Function. Fields: - name (required): str
1 property
1 required
ChatCompletionMessageToolCallChunk
object
Schema for ChatCompletionMessageToolCallChunk. Fields: - index (required): int - id (optional): str - type (optional): Literal["function"] - function (optional…
4 properties
1 required
ChoiceLogprobs
object
Log probability information for the choice.
2 properties
MCPServers
array
List of MCP server inputs (slugs or structured specs).
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Dedalus Labs publishes across the network.