Multimodal Chat

Chat completion and image generation capabilities, including vision-enhanced chat and text-to-image generation.

POSTv1/19/cortext/chat

Cortext Chat

Generate specialized responses using Cortext-based chat completion.

Required attributes

Name
model
Type
string
Description
The Cortext model to use.
Default: cortext-ultra
Name
messages
Type
array
Description
Array of message objects which must contain role ("user", "assistant", or "system") and content.

Optional attributes

Name
temperature
Type
number
Description
Controls randomness in the response.
Default: 0.0001
Name
max_tokens
Type
integer
Description
Maximum number of tokens to generate.
Default: 4000
Name
top_p
Type
number
Description
Controls diversity via nucleus sampling.
Default: 1
Name
stream
Type
boolean
Description
Whether to stream the response.
Default: true
Name
seed
Type
integer
Description
Random seed for reproducibility.
Default: 0

Response model

Name
choices
Type
array
Description
Array containing the completion messages, including role, content and finish_reason.
Name
system_fingerprint
Type
string | null
Description
System fingerprint for the completion, if available.
Name
id
Type
string
Description
Unique identifier for the completion.
Name
created
Type
integer
Description
Unix timestamp of when the completion was created.
Name
usage
Type
object
Description
Token usage statistics for the completion, including prompt_tokens, completion_tokens and total_tokens.
Name
object
Type
string
Description
Object type.
Name
model
Type
string
Description
The model used for completion.

This endpoint is authenticated. Get your API key ↗

Request

POST

v1/19/cortext/chat

curl -X POST "https://api.bitmind.ai/oracle/v1/19/cortext/chat" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cortext-ultra",
    "messages": [
      {
        "role": "user",
        "content": "What is machine learning?"
      }
    ],
    "temperature": 0.0001,
    "max_tokens": 100,
    "top_p": 1,
    "stream": false,
    "seed": 1
  }'

Response

[
  {
    "choices": [
      {
        "message": {
          "role": "user",
          "content": "Machine learning is a subset of artificial intelligence (AI) that involves the development of algorithms and statistical models that enable computers to perform tasks without explicit instructions. Instead of being programmed with specific rules, machine learning systems learn from data to identify patterns, make decisions, and improve their performance over time.\n\nKey aspects of machine learning include:\n\n1. **Data Input**: Machine learning models require large amounts of data to learn from. This data can be structured (like databases) or unstructured (like text and"
        },
        "finish_reason": "stop"
      }
    ],
    "system_fingerprint": null,
    "id": "chatcmpl-tEGXiayjTs_QuCyYdRhYyA",
    "created": 1739374983,
    "usage": {
      "prompt_tokens": 25,
      "completion_tokens": 101,
      "total_tokens": 126
    },
    "object": "chat.completion",
    "model": "gpt-4o"
  }
]

POSTv1/19/cortext/text-to-image

Cortext Text to Image

Generate images from text descriptions using Cortext models.

Required attributes

Name
messages
Type
string
Description
The prompt used to create the image.
Name
model
Type
string
Description
The model used to generate the image.
Default: cortext-image
Name
size
Type
string
Description
The dimensions of the created image.
Available options:
- 256x256
- 512x512
- 1024x1024
Default: 1024x1024
Name
quality
Type
string
Description
The quality/resolution of the generated images.
Available options:
- hd
- standard
Default: standard

Optional attributes

Name
provider
Type
string
Description
The provider used for text-to-image generation.
Default: OpenAI
Name
steps
Type
integer
Description
Number of steps in the image generation process.
Default: 5
Name
cfg_scale
Type
integer
Description
Classifier-Free Guidance Scale.
Default: 8
Name
style
Type
string
Description
Optional style parameter.

Response model

Name
messages
Type
string
Description
The original message content.
Name
model
Type
string
Description
The model used for image generation.
Name
style
Type
string
Description
The style used for the image.
Name
size
Type
string
Description
The dimensions of the created image.
Name
quality
Type
string
Description
The quality of the generated image.
Name
completion
Type
null
Description
Completion information (if available).
Name
steps
Type
integer
Description
Number of steps used in generation.
Name
sampler
Type
string
Description
The sampler algorithm used.
Name
cfg_scale
Type
integer
Description
The Classifier-Free Guidance Scale used.
Name
seed
Type
integer
Description
The random seed used for generation.
Name
provider
Type
string
Description
The provider of the image generation service.
Name
prompt
Type
string
Description
The prompt used to create the image.
Name
image_url
Type
string
Description
URL to the generated image.

This endpoint is authenticated. Get your API key ↗

Request

POST

v1/19/cortext/text-to-image

curl -X POST "https://api.bitmind.ai/oracle/v1/19/cortext/text-to-image" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A beautiful sunset over mountains",
    "model": "cortext-image",
    "style": "vivid",
    "size": "1024x1024",
    "quality": "hd",
    "steps": 30,
    "cfg_scale": 8,
    "seed": 0
  }'

Response

[
  {
    "messages": "Give me an image of a cute, phantom, cockapoo. Very cute, not too fluffy",
    "model": "cortext-image",
    "style": "vivid",
    "size": "1024x1024",
    "quality": "hd",
    "completion": null,
    "steps": 30,
    "sampler": "",
    "cfg_scale": 8,
    "seed": 0,
    "provider": "OpenAI",
    "prompt": "A beautiful sunset over mountains",
    "image_url": "https://corcel.b-cdn.net/3294af65-bb87-4be3-9c46-5f50b39213ab.webp"
  }
]

POSTv1/19/vision/chat

Vision Chat

Generate responses with vision-enhanced capabilities for image-related discussions.

Required attributes

Name
messages
Type
array
Description
Array of message objects with role and content. Each message must include role (enum: "user", "assistant", "system") and content (array of content objects).

Optional attributes

Name
model
Type
string
Description
The vision model to use.
Default: llama-3
Name
temperature
Type
number
Description
Controls randomness in the response.
Default: 0.1
Name
max_tokens
Type
integer
Description
Maximum number of tokens to generate.
Default: 500
Name
top_p
Type
number
Description
Controls diversity via nucleus sampling.
Default: 1
Name
stream
Type
boolean
Description
Whether to stream the response.
Default: true
Name
logprobs
Type
boolean
Description
Whether to include log probabilities.
Default: false

Response model

Name
id
Type
string
Description
Unique identifier for the completion.
Name
object
Type
string
Description
Object type.
Name
created
Type
integer
Description
Unix timestamp of when the completion was created.
Name
model
Type
string
Description
The model used for completion.
Name
choices
Type
array
Description
Array containing the completion messages, including message.role and message.content.
Name
usage
Type
object
Description
Token usage statistics for the completion.
Name
system_fingerprint
Type
string | null
Description
System fingerprint for the completion, if available.

This endpoint is authenticated. Get your API key ↗

Request

POST

v1/19/vision/chat

curl -X POST "https://api.bitmind.ai/oracle/v1/19/vision/chat" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "Hello, how are you?"
      }
    ],
    "model": "llama-3",
    "temperature": 0.1,
    "max_tokens": 100,
    "top_p": 1,
    "stream": false,
    "logprobs": false
  }'

Response

{
  "id": "chatcmpl-Q3g9MriBTyCAh9KrbFVN9g",
  "object": "chat.completion",
  "created": 1739377516,
  "model": "llama-3-1-70b",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Hello! I'm just a computer program, so I don't have feelings, but thank you for asking! How can I assist you today?"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 19,
    "completion_tokens": 64,
    "total_tokens": 83
  },
  "system_fingerprint": null
}

POSTv1/19/vision/text-to-image

Vision Text to Image

Generate images using the vision model's text-to-image capabilities.

Required attributes

Name
text_prompts
Type
array
Description
Array of prompt objects, each containing text (string) and optional weight (number).

Optional attributes

Name
cfg_scale
Type
integer
Description
Classifier free guidance scale.
Default: 2
Name
steps
Type
integer
Description
Number of diffusion steps.
Default: 8
Name
engine
Type
string
Description
The engine to use.
Default: proteus
Name
height
Type
integer
Description
Output image height in pixels.
Default: 1024
Name
width
Type
integer
Description
Output image width in pixels.
Default: 1024

Response model

Name
signed_urls
Type
array
Description
Array of URLs to the generated images.

This endpoint is authenticated. Get your API key ↗

Request

POST

v1/19/vision/text-to-image

curl -X POST "https://api.bitmind.ai/oracle/v1/19/vision/text-to-image" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "cfg_scale": 2,
    "height": 1024,
    "width": 1024,
    "steps": 8,
    "engine": "proteus",
    "text_prompts": [
      {
        "text": "4 hedgehogs, wearing tuxedos, riding on the back of a crocodile."
      }
    ]
  }'

Response

{
  "signed_urls": [
    "https://corcel.b-cdn.net/df42dc09-6de4-4c38-b716-5a0f064304c0.webp"
  ]
}

Last updated: April 10, 2025