Skip to main content
POST
/
gpt-5-2
/
v1
/
chat
/
completions
Chat Completions
curl --request POST \
  --url https://api.kie.ai/gpt-5-2/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "What is in this image?"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1759055072437dqlsclj2.png"
          }
        }
      ]
    }
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "web_search"
      }
    }
  ],
  "reasoning_effort": "high"
}
'
{
  "id": "chatcmpl-example-123",
  "object": "chat.completion",
  "created": 1741569952,
  "model": "gpt-5-2",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "hello,can i help you?",
        "refusal": null,
        "annotations": []
      },
      "logprobs": null,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 50,
    "total_tokens": 60
  }
}

Multimodal

Supports text and image inputs

Real-time Search

Web search grounding enabled

Reasoning Effort

Adjustable reasoning effort level

Flexible Roles

Multiple message roles supported

​
Unified Media File Format

In the messages parameter’s content array, only images are supported. All image files use the same format structure:
  • The type field is always "image_url"
  • The image_url field name remains unchanged
  • The only thing that changes is the url value, which points to the corresponding image address
For example: { type: 'image_url', image_url: { url: '...' } } structure.

​
Tools Parameter

The tools parameter is an optional array that allows you to enable Web Search grounding. 
{
  "id": "chatcmpl-example-123",
  "object": "chat.completion",
  "created": 1741569952,
  "model": "gpt-5-2",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "hello,can i help you?",
        "refusal": null,
        "annotations": []
      },
      "logprobs": null,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 50,
    "total_tokens": 60
  }
}

Authorizations

​
Authorization
string
header
required

All APIs require authentication via Bearer Token.

Get API Key:

  1. Visit API Key Management Page to get your API Key

Usage: Add to request header: Authorization: Bearer YOUR_API_KEY

Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately in the management page

Body

application/json
​
messages
object[]
required

An array of message objects. Each message has a role and content.

Unified Media File Format:

In the content array, only images are supported. All image files use the same format structure:

  • The type field is always "image_url"
  • The image_url field name remains unchanged
  • The only thing that changes is the url value, which points to the corresponding image address

For example: { type: 'image_url', image_url: { url: '...' } } structure.

Minimum array length: 1
​
tools
object[]

An optional array of tools the model may call. Supports Web Search: {"type": "function", "function": {"name": "web_search"}} - Enables real-time information retrieval via Web Search.

​
reasoning_effort
enum<string>
default:high

The effort level for the model to use for reasoning. Low effort is faster to respond, high effort is slower to respond but solves more complex problems. Default is "high".

Available options:
low,
high

Response

Request successful. Returns the standard chat completion format.

​
id
string

Unique identifier for the chat completion

Example:

"chatcmpl-example-123"

​
object
string

Object type

Example:

"chat.completion"

​
created
integer<int64>

Unix timestamp of when the completion was created

Example:

1677652288

​
model
string

Model name

Example:

"gpt-5-2"

​
choices
object[]

Array of completion choices

​
usage
object