The AI Search service combines advanced language models with specialized search capabilities to provide intelligent search results.

The API reference for this endpoint is not yet available in OpenAPI format. Use the examples below to make requests.

Base URL

https://api.taam.cloud/v1

Authentication

Authentication is handled through the standard Bearer token header. Get your API key from the API Key Management Guide.

Request Format

model
string
default:"taam-ai-search"
required

Model identifier for AI search (must be set to taam-ai-search)

params
object
required

Example Request

curl --location 'https://api.taam.cloud/v1/web' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "model": "taam-ai-search",
    "params": {
        "query": "What is Perplexica",
        "chatModel": {
            "provider": "openai",
            "model": "gpt-4o-mini"
        },
        "embeddingModel": {
            "provider": "openai",
            "model": "text-embedding-3-large"
        },
        "optimizationMode": "speed",
        "focusMode": "webSearch"
    }
}'

Response Format

id
string

Unique identifier for the search request

object
string

Object type (e.g., “search.completion”)

created
integer

Unix timestamp for when the request was created

model
string

Model used for the search

choices
array
usage
object

Example Response

{
    "id": "search-f0e3e9a4f72a42a29c428e36d9a53717",
    "object": "search.completion",
    "created": 1741151462,
    "model": "taam-ai-search",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "Taam Cloud is an innovative AI API platform designed to facilitate ....",
                "sources": [
                    {
                        "pageContent": "Taam API . seamless integration of AI-driven models . Taam Hub . All-In-One WordPress Management . Email Marketing . Email campaigns to promote products . PRODUCTS. Taamly socail Poster . create, schedule, publish to social media . AI Image Genrator ...",
                        "metadata": {
                            "title": "AI API Playground for Developers | Taam.cloud",
                            "url": "https://taam.cloud/"
                        }
                    },

                    {
                        "pageContent": "Meaning app team one, they might be all in on Amazon. App team two, they're picking and choosing. App team three, they're building something themselves. So it's this chaotic approach where each team is picking their own tooling, approaching it their own way, building their own pipelines, building their own process for how they're adopting cloud.",
                        "metadata": {
                            "title": "What is a platform team and what problems do they solve? - HashiCorp",
                            "url": "https://www.hashicorp.com/resources/what-is-a-platform-team-and-why-do-we-need-them"
                        }
                    }
                ],
                "videos": [
                    {
                        "url": "https://www.youtube.com/watch?v=iojibP9pg9g",
                        "img_src": "https://i.ytimg.com/vi/iojibP9pg9g/hqdefault.jpg",
                        "title": "How to use Technical Account Management (TAM) with Google Cloud Premium Support",
                        "iframe_src": "https://www.youtube-nocookie.com/embed/iojibP9pg9g"
                    }
                    
                ],
                "images": [
                    {
                        "url": "https://docs.taam.cloud/introduction",
                        "img_src": "https://mintlify.s3.us-west-1.amazonaws.com/taamai-c8c27d6c/images/home.png",
                        "title": "Welcome to Taam Cloud - Taam Cloud API"
                    }
                    
                ],
                "suggestions": [
                    "What are the key features of the latest smartphone models released this year?"
                ]
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 1,
        "completion_tokens": 1474,
        "total_tokens": 1475,
        "prompt_tokens_details": {
            "cached_tokens": 0,
            "text_tokens": 0,
            "audio_tokens": 0,
            "image_tokens": 0
        },
        "completion_tokens_details": {
            "text_tokens": 0,
            "audio_tokens": 0
        }
    },
    "system_fingerprint": "fp_61a4ca71"
}