Responses（Deep-Research） - 302.AI API Document

Request

Header Params

Body Params application/json

Example

{
    "model": "o4-mini-deep-research",
    "input": [
        {
            "role": "user",
            "content": "Write a one-sentence bedtime story about a unicorn."
        }
    ],
    "tools": [{"type": "web_search_preview"}]
}

Request Code 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/responses' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "o4-mini-deep-research",
    "input": [
        {
            "role": "user",
            "content": "Write a one-sentence bedtime story about a unicorn."
        }
    ],
    "tools": [{"type": "web_search_preview"}]
}'

Responses

🟢200OK

application/json

Body

Example

{
    "background": false,
    "billing": {
        "payer": "developer"
    },
    "completed_at": 1768200327,
    "created_at": 1768200290,
    "frequency_penalty": 0,
    "id": "resp_04bcfa20d0e817b30069649862421c8195bf5be0547e286c36",
    "incomplete_details": null,
    "instructions": null,
    "max_output_tokens": null,
    "max_tool_calls": 225,
    "metadata": {},
    "model": "o4-mini-deep-research",
    "object": "response",
    "output": [
        {
            "id": "rs_04bcfa20d0e817b30069649862f0d481959321f8f493fa0d55",
            "summary": [],
            "type": "reasoning"
        },
        {
            "content": [
                {
                    "annotations": [],
                    "logprobs": [],
                    "text": "Beneath a silver moon and a blanket of twinkling stars, a gentle unicorn with a shimmering rainbow mane glided through a moonlit meadow until it found a cozy cloud to curl up on and drifted peacefully into dreamland.",
                    "type": "output_text"
                }
            ],
            "id": "msg_04bcfa20d0e817b30069649886d96c8195bc41f1f502cba9d1",
            "role": "assistant",
            "status": "completed",
            "type": "message"
        }
    ],
    "parallel_tool_calls": true,
    "presence_penalty": 0,
    "previous_response_id": null,
    "prompt_cache_key": null,
    "prompt_cache_retention": null,
    "reasoning": {
        "effort": "medium",
        "summary": null
    },
    "safety_identifier": null,
    "service_tier": "default",
    "status": "completed",
    "store": true,
    "temperature": 1,
    "text": {
        "format": {
            "type": "text"
        },
        "verbosity": "medium"
    },
    "tool_choice": "auto",
    "tools": [
        {
            "search_context_size": "medium",
            "type": "web_search_preview",
            "user_location": null
        }
    ],
    "top_logprobs": 0,
    "top_p": 1,
    "truncation": "disabled",
    "usage": {
        "input_tokens": 429,
        "input_tokens_details": {
            "cached_tokens": 0
        },
        "output_tokens": 7478,
        "output_tokens_details": {
            "reasoning_tokens": 7424
        },
        "total_tokens": 7907
    },
    "user": null
}