Skip to main content
POST
/
chat
/
completions
Analyze Images with Vision Models
curl --request POST \
  --url https://platform.qubrid.com/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "Qwen/Qwen3-VL-Plus",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "What is in this image? Describe the main elements."
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
          }
        }
      ]
    }
  ],
  "max_tokens": 16384,
  "temperature": 0.1,
  "top_p": 1,
  "stream": true
}
'
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1710000000,
  "model": "Qwen/Qwen3-VL-Plus",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "The image shows the Statue of Liberty standing on Liberty Island in New York Harbor, with water and city skyline elements visible in the background."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 120,
    "completion_tokens": 48,
    "total_tokens": 168
  },
  "x_metrics": {
    "ttft_seconds": 0.41,
    "tps": 38.4,
    "total_time_seconds": 1.92
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
string
required

The multimodal vision-language model to use.

Example:

"Qwen/Qwen3-VL-Plus"

messages
object[]
required

Chat-style input containing text instructions and image content.

max_tokens
integer
default:16384

Maximum number of tokens to generate in the response.

temperature
number
default:0.1

Sampling temperature controlling response variability.

top_p
number
default:1

Nucleus sampling parameter.

stream
boolean
default:true

Whether to stream output incrementally.

Response

Vision analysis completed successfully

Standard OpenAI-compatible chat completion response or streamed chunks.

id
string
Example:

"chatcmpl-abc123"

object
string
Example:

"chat.completion"

created
integer
Example:

1710000000

model
string
Example:

"Qwen/Qwen3-VL-Plus"

choices
object[]
usage
object
x_metrics
object

Performance metrics for the request.