Sign in

v1

latestOpenAPI 3.1.02026-08-0411826.2 KB

Create chat completion

Creates a model response for the given chat conversation.

post/chat/completions

Headers

Authorizationstring required

Bearer <your-api-key>

Content-Typestring required

application/json

x-show-additional-info'true' | 'false'

Set to true to include precontext inline at the start of a streamed response. Defaults to false.

Request body

model'interfaze-beta' required

Model id to use. Currently the only supported value is interfaze-beta.

streamboolean

If true, partial message deltas are sent as server-sent events. The stream terminates with data: [DONE].

reasoning_effort'low' | 'medium' | 'high'

Enables extended reasoning. The model spends more compute and thinking tokens before producing a final answer. low = light reasoning pass, medium = moderate reasoning, high = deep reasoning (recommended for math, science, complex agents). When set, the response contains a reasoning field. In streaming mode, reasoning tokens stream first inside <think>...</think> tags. Off by default.

max_tokensinteger

Maximum number of tokens to generate in the completion. Hard upper bound of 32,000 tokens.

temperaturenumber

Sampling temperature between 0 and 2. Higher values produce more random output, lower values make the output more focused and deterministic.

top_pnumber

Nucleus sampling. The model considers only the tokens whose cumulative probability mass is top_p. 0.1 means only the top 10% of probability mass is sampled from. Generally only adjust one of temperature or top_p.

Example request

{
  "model": "interfaze-beta"
}

Response

Successful chat completion response.

idstring

Unique identifier for the completion.

object'chat.completion'

Always chat.completion.

modelstring

The model used.

reasoningstring

Present when reasoning_effort is set. The model's thinking trace.

vcacheboolean

Whether the response was served from the model's verified cache.

Example response

{
  "id": "interfaze-1775270750639",
  "object": "chat.completion",
  "model": "interfaze-beta",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "{\"name\":\"Yoeven D Khemlani\"}"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10512,
    "completion_tokens": 7056,
    "total_tokens": 17568
  },
  "vcache": false,
  "precontext": [
    {
      "name": "web_search",
      "result": [
        {
          "title": "Interfaze | Y Combinator",
          "url": "https://www.ycombinator.com/companies/interfaze",
          "description": "AI model built for deterministic developer tasks."
        }
      ]
    }
  ]
}