Completions

Create completions based on provided messages or prompt and sources.

Completions endpoint is used in scenarios where you need to generate text based on a given context, either provided through a conversation history (messages) or a specific starting prompt. The sources parameter helps to contextualize the completion by specifying the indexes to use.

The response should look something like this:

Body Parameters:

Name	Type	Description	Required
messages	array	An array of message objects. Each message object contains a role and content. This simulates a conversation history.	Yes (or prompt)
prompt	string	A string prompt to generate completions. This is used when there are no prior messages to base the completion on.	Yes (or messages)
sources	array	An array of strings representing index ID or DID to be used as a source for generating completions.	Yes

Note: Either messages or prompt must be provided, along with sources.

Example Request Body

Using Messages:

{
  "messages": [{
      "role": "user",
      "content": "Tell me a joke."
  }],
  "sources": [
    "kjzl6kcym7w8y8lefkkbpl44q6jh1zu78gaq2zp18we4wdgz1tz9vxyx213ochh"
  ]
}

Create Completions

POSThttps://dev.index.network/api/discovery/completions

Authorization

didSessionAuth

Body

application/json

messagesarray of object

promptstring

sourcesarray of string

Response

200400401500

Completions created

Body

application/json

completionstring

Request

JavaScriptCurlPython

const response = await fetch('https://dev.index.network/api/discovery/completions', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer DID_SESSION_SERIALIZED",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "completion": "text"
}