Messages（Thinking mode） - 302.AI API Document

Request

Header Params

Content-Type

string

required

Example:

application/json

Accept

string

required

Example:

application/json

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

model

string

required

The ID of the model to be used. For detailed information on which models are applicable to the chat API, please view Model endpoint compatibility

max_tokens

integer

required

The maximum number of tokens that can be generated in the chat completion.The total length of input tokens and generated tokens is limited by the model's context length.

tools

array [object {3}]

required

Tool Call Tool Use passes tool parameters

name

string

optional

description

string

optional

input_schema

object

optional

tool_choice

object

optional

Set the mode of tool call

type

string

required

messages

array [object {2}]

required

Generate a chat completed message in a chat format.

role

string

optional

content

string

optional

stop_sequences

string

optional

Up to 4 sequences where the API will stop generating further tokens.

temperature

number

optional

What sampling temperature to use, ranging from 0 to 2. Higher values, such as 0.8, will make the output more random, while lower values, like 0.2, will make it more focused and deterministic. We generally recommend adjusting either this or top_p, but not both simultaneously.

top_p

integer

optional

An alternative to temperature sampling is nucleus sampling, where the model considers tokens within the top_p probability mass. For instance, top_p = 0.1 means only tokens within the top 10% probability mass are considered. We recommend adjusting either this or temperature, but not both simultaneously.

top_k

string

optional

An alternative to temperature sampling

stream

boolean

optional

If set, partial message deltas will be sent, like in ChatGPT. Tokens will be sent as data-only server-sent events as they become available, with the stream terminated by data: [DONE] message. For Example Code.，Please view OpenAI Cookbook.

system

string

optional

system prompt

Example

{
    "model": "claude-3-7-sonnet-20250219",
    "max_tokens": 20000,
    "thinking": {
        "type": "enabled",
        "budget_tokens": 16000
    },
    "messages": [
        {
            "role": "user",
            "content": "What is 27 * 453?"
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.302.ai/v1/messages' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "claude-3-7-sonnet-20250219",
    "max_tokens": 20000,
    "thinking": {
        "type": "enabled",
        "budget_tokens": 16000
    },
    "messages": [
        {
            "role": "user",
            "content": "What is 27 * 453?"
        }
    ]
}'

Responses

🟢200OK

application/json

Body

id

string

required

type

string

required

role

string

required

model

string

required

content

array [object {2}]

required

type

string

optional

text

string

optional

stop_reason

string

required

stop_sequence

null

required

usage

object

required

input_tokens

integer

required

cache_creation_input_tokens

integer

required

cache_read_input_tokens

integer

required

output_tokens

integer

required

Example

{
    "id": "msg_01QyXuu5DMbJWUN22Ys6Kvoh",
    "type": "message",
    "role": "assistant",
    "model": "claude-3-5-sonnet-20240620",
    "content": [
        {
            "type": "text",
            "text": "Hello! How can I assist you today? Feel free to ask me any questions or let me know if you need help with anything."
        }
    ],
    "stop_reason": "end_turn",
    "stop_sequence": null,
    "usage": {
        "input_tokens": 10,
        "cache_creation_input_tokens": 0,
        "cache_read_input_tokens": 0,
        "output_tokens": 30
    }
}